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PREFACE 


MANUAL  OBJECTIVES 

The  purpose  of  this  manual  is  to  show  programmers  how  to  use  PDP-11 
FORTRAN-77  DEBUG  to  debug  their  programs.  The  manual  serves  both  as 
an  instructional  guide  and  as  a  reference  source. 

tNTENDED  AUDIENCE 

This  manual  is  intended  for  programmers  with  all  levels  of  experience. 
The  manual  assumes  that  the  reader  is  familiar  with  PDP-11  FORTRAN-77 
and  has  some  knowledge  of  the  host  operating  system. 

STRUCTURE  OF  THIS  DOCUMENT 

This  manual  is  organized  as  follows: 

•  Chapter  1  gets  you  started  in  a  debugging  session^ 

•  Chapter  2  describes  the  debugger's  symbolic  capabilities. 

•  Chapter  3  shows  how  to  suspend  and  monitor  prog'^am  execution. 

•  Chapter  4  shows  how  to  examint^  and  deposit  data. 

•  Chapter  5  summarizes  the  DEBUG  commands. 

•  Appendix  A  contains  an  example  program. 

•  Appendix  B  lists  and  explains  error  messages. 


ASSOCIATED  DOCUMENTS 


•  PDP-11  FOPTRAN-77  User's  Guide 

•  PPP^ll  FORTRAN-77  Language  Reference  Manual 

•  PDP-11  FQRTRAN-77  Object  Time  System  Reference  Manual 

•  PDP-11  FORTRAN-77  Installation  Guide/Release  Notes 

•  RSX-llM/M-PLUS  Task  Builder  Manual 
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•  RSTS/E  System  Manager's  Guide 

•  RSTS/E  System  User's  Guide 
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PREFACE 


•  RSTS/E  Task  Builder  Reference  Manual 

•  VAX~11/RSX~11M  User's  Guide 

•  VAX- 11  RSX-llM  Programmer's  Reference  Manual 

CONVENTIONS  USED  IN  THIS  DOCUMENT 

The  following  conventions  are  observed  in  this  manual: 

•  Uppercas  words  and  letters  used  in  examples  indicate  that  you 
should  ^    pe  the  word  or  letter  exactly  as  shown. 


Lowercase  words  and  letters  used  in  examples  indicate  ti. 
are  to  substitute  a  word  or  value  of  your  choice. 

Brackets  ([])  indicate  optional  elements. 


you 


An  ellipsis  (...)  indicates  that  the  preceding  item(s)  can  be 
repeated  one  or  more  times. 

represents  a  carriage  return. 

RSX-11   is  used   as   a  generic   term  for   the   RSX-llM  and 
RSX-llM-PLUS  operating  systems. 

Text  printed  in  ted  ink  indicates  user   input   in   interactive 
examples. 


% 


• 
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INTRODUCTIOM  TO  THE  DEBUGGER 


PDP-ll  FORTRAN-77  DEBUG  is  a  symbolic  debugger  designed  to  help  you 
find  logic  and  programming  errors  in  a  successfully  compiled  program 
that  does  not  run  correctly.  For  exd!!i»ple^  the  program  may  terminate 
abnormally,  give  incorrect  output,  or  go  into  an  infinite  loop.  By 
allowing  you  to  stop  and  start  program  execution  where  you  want,  to 
look  at  any  location,  and  to  change  the  contents  of  locations,  the 
debugger  assists  you  in  isolating  and  correcting  your  program's 
errors. 


1.1   DEBUGGER  FEATURES 

PDP-11  FORTRAN-77  DEBUG  is  a  powerful  and  flexible  tool   to   help   you 
find  errors  in  your  program.   The  following  are  its  main  features: 

•  It  is  interactive.  You  issue  debugger  commands  from  your 
terminal  and  see  their  effects  immediately. 

•  It  is  symbolic.  You  can  refer  to  program  locations  by 
symbols,  rather  than  virtual  addresses,  and  receive  debugger 
output  in  symbolic  form. 


It  understands  FORTRAN-77  variable  names  and  data   types, 
accepts  a'.d  displays  data  in  a  variety  of  formats. 


It 


It  supports  overlaid  programs.  You  can  set  breakpoints  and 
tracepoints  in  overlay  segments  that  are  not  currently 
resident. 

It  gives  on-line  help.  When  you  type  HELP,  the  debugger 
responds  w'th  a  list  of  commands  and  related  features  about 
which  you  can  receive  information  during  a  debugging  session. 


1.2   BBGIIINIIiG  AND  ENDING  A  DEBUGGING  SESSION 

On  all  the  operating  systems  that  support  PDP-11  FORTRAN-77  DEBUG,  you 
must  compile  and  task-build  with  certain  switches  in  order  to  have 
debugging  capabilities.  The  system-specific  commands  for  compiling, 
task-building,  and  executing  a  program  with  the  debugger  are  discussed 
in  Sections  1.2.1-  le2.2,  and  1.2.3. 

Onr*:  Che  debugger  lakes  control  of  program  execution,  a  message  like 
Che  following  one  appears  Jt  your  terminal: 


m 


PDF- 11  FORTRAN-77  DCBUG/v.iiS    VI.  0 

%F77DBG-I-INISTBNAM,  TKB-speci f i<*d  STB  file  Is  •  bBBO : (SMITH] MVPROG .STB" 
D83> 
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The  DBO  prompt  indicates  that  the  debugger  is  ready  to  accept 
commands.  You  respond  to  the  prompt  with  one  of  the  commands 
recognized  by  the  debugger.   They  are  summarized  in  Chapter  5. 

To  terminate  a  debugging  session,  use  the  EXIT  command: 

DBO  EX  IT 

When  your  program  has  bten  thoroughly  debugged,  you  can  compile  and 
task-build  it  again  without  the  debugging  qualifiers. 


1.2.1   RSX-llM/M-PLUS 

Assume  that  you  have  created  a  FORTRAN-77  source  file  called 
MYPROG.PTN.  To  execute  MYPROG.FTN  f r >m  an  MCR  terminal,  you  must 
compile,  task-build,  and  run  it  with  the  following  commands: 

>  F77  myprog»myprog/DB 

>  TKB   myprog , ,myprog=myprog ,LB: [1 , 1] F77DBG/DA 

>  RUN   myprog 


NOTE 

In  the  TKB  command  line,  the  third  file 
specified  (not  the  second,  which  is  null 
here)  is  the  STB  file,  which  contains 
symbol  definitions  for  the  debugger's 
use.  If  you  fail  to  specify  the  STB 
file,  you  will  have  a  debugger  that 
lacks  many  of  its  functions. 

To  execute  the  same  program  from  a  DCL  terminal,   compile, 
run  MYPROG  with  the  following  commands: 


link,   and 


$  FORTRAN/F77/DEBUG   myprog 

$  LINK/DEBUG=LB: [1,1) F77DBG/SYMBOL 

$  RUN  myprog 


myprog 


1.2.2   RSTS/E 

Assume  yoc  have  created  a  FORTRAN-77  source  file  called  MYPROG.FTN. 
To  execute  MYPROG.FTN  at  an  MCR  terminal,  you  must  compile, 
task-build,  and  run  it  with  the  following  commands: 

>  F77  myprog»myprog/DB 

>  TKB  myprog , ,myprog«myprog , LB: F77DBG/DA 

>  D77  myprog 


NOTE 

In  the  TKB  command  line,  the  third  file 
specified  (not  the  second,  which  is  null 
here)  is  the  STB  file,  which  contains 
symbol  definitions  for  the  debugger's 
use.  If  you  fail  to  specify  the  SIB 
file,  you  will  have  a  debugger  that 
lacks  many  of  its  functions. 
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When  using  RSTS/B  at  a  DCL  terminal,  use   the 
compile,  link,  and  run  MYPROG.FTN: 

S  FORTRAN/DEBUG  myprog 

$  TKB  myprog,, myprog=myproij, LB :F77DBG/DA 
$  D77  myprog 


following  commands   to 


1.2.3  VAX/VMS  under  the  ANE 

Assume  you  have  created  a  FORTRAN-77  source  file  called  MYPROG.FTN. 
To  compile,  link,  and  run  MYPROG.FTN  on  a  VAX/VMS  system,  use  the 
following  sequence  of  commands: 

$  MCR  P77  myprog«myprog/DB 

$  MCR  TKB  myprog,, myprog»myprog, LB: [1,1] F77DBG/DA,F4P0TS/LB 

or 

$  LINK/RSX/DEBUG«F77DBG/SYMBOr   myprog 
$  RUN  myprog 


1.2.4   Effects  of  Optimization 

Although  all  the  debugger  functions  remain  available  if  you  debug 
optimized  code,  it  is  recommended  that  you  debug  unoptimized  code. 

If  you  debug  an  optimized  program,  you  may  get  unexpected  results. 
For  example,  when  code  is  optimized,  certain  variable  locations, 
particularly  within  loops,  may  not  have  values  in  them;  the  values 
may  be  in  registers  instead  of  the  locations  you  want  to  examine.  In 
addition,  in  an  optimized  program  there  is  no  guarantee  that  lines 
correspond  to  instructions  in  the  way  you  expect  them  to.  Thus,  the 
results  of  stepping  through  a  program  by  line  or  instruction  may  be 
unpredictable. 

To  ivoid  difficulties,  use  the  /NOOP  switch  when  you  compile. 


1.2.5  Control  Characters 

The  CTRL/C  character  does  the  following: 

•  On  RSX-llM-PLUS  it  returns  your  terminal  to  the  command 
language  interpreter  (CLI) .  If  you  then  enter  the  DEBUG 
command,  the  debugger  issues  a  message  and  its  prompt. 

•  On  RSX-llM  it  returns  your  terminal  to  the  CLI.  If  you 
terminate  with  CTRL/C,  there  is  no  way  to  recapture  the 
debugger  without  starting  the  debugging  session  over  again. 

•  On  RSTS/E  it  interrupts  program  execution  and  returns  control 
to  the  debugger. 

On  VAX/VMS,  you  may  type  either  CTRL/Y  or  CTRL/C  to  interrupt  program 
execution.  In  each  case,  you  are  returned  to  the  CLI  and  can  then 
type  the  DEBUG  command  to  reenter  the  debugging  session. 

The  CTRL/2  character  causes  orderly  termination  of  the  debugger  on  all 
systems. 
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1.3   DEBUGGER  COMMAND  SYNTAX 

The  debugger  command  syntax  is  much  like  DCL  command  syntax.  The 
specific  format  for  each  command  is  given  alphabetically  by  command  in 
Chapter  5;   the  general  format  follows: 

command  [/qualifier]  [parameter]  [WHEN (value-expr ) ]  [DO(action)]  ['comment] 

The  coiUBand  naae  consists  of  one  or  two  keywords  and  indicates  the 
function  to  be  carried  out.  The  qualifier  modifies  the  function  and 
must  be  preceded  by  a  slash  (/) ) .  The  parameter  is  acted  upon  by  the 
command.  The  mEN...DO  sequence  is  used  in  certain  commands  to 
specify  that  a  further  action  should  be  carried  out  under  particular 
conditio  i  of  program  execution.  A  coanment 
ignored  by  the  command  interpreter.  It  follows 
preceded  by  an  exclamation  point  (!). 
exclamation  point  is  a  comment. 


is  information  that  is 
a  command,  and  must  be 
Everything   after   the 


You  may  abbreviate  debugger  command  keywords.  The  minimal 
abbreviation  for  each  keyword  must  have  as  many  characters  as  are 
needed  to  make  it  unique  within  the  set  of  all  keywords.  Exceptions 
to  this  rule  are  the  EXAMINE,  DEPOSIT,  STEP,  and  GO  commands:  They 
may  be  abbreviated  to  their  first  letter. 


You  can  type  more  than  one  command   on   a 
separate  all  commands  with  a  semicolon. 


terminal   line.    You  must 


You  can  continue  a  command  on  a  new  terminal  line  by  ending  the  line 
with  a  hyphen  (-)  and  then  pressing  RETURN,  The  debugger  then  prompts 
you  with  an  underscore  for  the  remainder  of  the  command. 

After  you  type  a  command,  enter  the  command  by  pressing  the  RETURN 
^ey. 


1.4   LOG  PILES 

At  your  request,  the  debugger  can  keep  a  record  of  a  debugging  session 
by  creating  a  log  file.  The  log  file  contains  all  the  commands  you 
issue,  as  well  as  all  the  debugger  responses  during  a  debugging 
session.  By  default,  debugger  output  goes  to  the  terminal  rather  than 
a  log  file. 

Output  to  a  log  file  is  identical  to  output  to  a  terminal,  with  two 
exceptions:  The  DBG>  prompt  does  not  appear  in  a  log  file,  and  each 
3 ine  of  debugger  response  in  a  log  file  is  preceded  by  a  comment 
oelimiter  (the  exclamation  point).  The  absence  of  the  prompt  and  the 
presence  of  the  exclamation  point  allow  you  to  execute  a  log  file  as 
an  indirect  conunand  file.  Section  1.5  tells  you  how  to  use  indirect 
command  files  with  the  debugger. 

To  request  a  debugger  log  file,  use  the  SET  OUTPUT  command  with  the 
LOG  parameter  as  follows: 


SET    OUTPUT    LOG 

The  name  of  the  log  file  created  is  DEBUG.LOG  unless  you  use  the  SET 
LOG  command  to  specify  a  different  name.  The  format  of  the  SET  LOG 
command    is: 

SET   LOG    file-spac 
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The  file-spec  parameter  is  the  name  of  the  file  to  which  you  want  the 

debugger   to  write  its  output.   If  you  do  not  specify  a  file  type,  the 

debugger  uses  the  default  file  type  LOG,   To  fir.d  out  the  name  of  the 
current  log  file,  use  the  SHOW  LOG  command. 


The  following  is  part  of  a  debugger  log  file: 


ev/ad  ^,nam$ 

117136 

e  11504 

111504:   17136 

set  br  two\two 

set  br  %seg  null3\three 

g 

istart  at  SUB3\%LINE  3 


+6 


t routine  breakpoint  at  TWO 


See  Chapter  5  for  complete  information  about  the  SET  OUTPUT  command. 

To  determine  which  output  parameters  are  in  effect,  issue  the  SHOW 
OUTPUT  command.  To  return  the  output  configuration  to  the  default 
(NOLOG,  TERMINAL,  NOVERIF  ),  issue  the  CANCEL  OUTPUT  command. 


1.5   INDIRECT  COMMAND  FILES 

An  indirect  command  file  contains  one  or  more  debugger  commands  and 
can  be  used  by  the  debugger  to  perform  debugging  operations.  An 
indirect  command  file  is  particularly  useful  when  you  want  to  execute 
the  same  series  of  commands  in  several  different  situations. 

You  use  an  editor  to  create  an  indirect  command  file.  To  execute  an 
indirect  command  file,  precede  nhe  name  of  the  file  with  an  "at  sign," 
as  follows: 


§file-spec 

If  you  do  not  specify  a  file  type,  the  debugger 
type  CMD. 


assumes   the  default 


You  can  issue  the  ^file-spec  command  from  the  terminal,  from  within  a 
DO  action,  or  from  within  another  command  file.  Commands  are  exrruted 
from  the  file  until  either  an  EXIT  command  or  end-of-file  is  reached. 
The  number  of  levels  to  which  you  can  nest  indirect  command  files  is 
limited  only  by  the  amount  of  dynamic  storage  currently  available. 

You  can  use  a  debugger  log  file  as  an  indirect  command  file.  This  is 
often  helpful  if  you  want  to  reexecute  part  of  a  p^'evious  debugging 
session  so  you  can  resume  where  you  left  off.  You  can  also  use  the 
log  file  as  a  command  file  in  another  program  or  in  a  modified  version 
of  the  same  program. 

The  parameters  VERIFY  and  NOVERIFY  used  with  the  SET  OUTPUT  command 
control  whether  the  debugger  displays  (either  on  the  terminal  or  in  a 
log  file)  the  command*-  in  a  command  file.  The  default  para'^eter  is 
NOVERIFY.  Thus,  if  you  want  the  debugger  to  display  the  c-  lands  it 
reacts  from  a  command  file,  you  must  specify: 

SET  OUTPUT  VERIFY 
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If  a  command  in  an  indirect  command  file  is  syntactically  incorrect, 
the  debugger  issues  an  error  message  and  continues  execution  with  the 
next  line  in  the  command  file. 


1.6   THE  HELP  COMMAND 

li  V >u  want  on-line  information  about  how  to  use  PDP-11  FORTRAN-77 
DEBUG  while  you  are  using  it,  issue  the  HELP  command  in  the  following 
format: 

HELP  help-topic  [subtopic] 

The  help  facility  provides  information  about  any  debugger  command,  its 

format,   qualifiers,   and  parameters.   The  facility  also  provides 

information  about  debugger  modes,  types,  pathname  formats,  and 
termination  procedures. 


a  list  of  ail  the  topics  on  which 
out  more  about  the  EXAMINE  command. 


If  you  type  only  HELP,  you  receive 
information  is  available.  To  find 
for  instance,  type: 

HELP  EXAMINE 

The  information  displayed  for  EXAMINE  includes  a  list  of  qualifiers 
that  may  be  used  with  the  command.  If  you  want  to  find  out  more  about 
using. the  /BYTE  qualifier  with  the  EXAMINE  command,  type: 

HELP  EXAMINE/BYTE 
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When  you  debug  symbolically,  you  use  symbols  instead  of  virtual 
addresses  to  refer  to  memory  locations.  Symbols  can  be  used  to 
represent  the  memory  locations  of  both  program  data  and  program 
addresses.  This  chapter  tells  you  how  to  use  symbols  to  debug  your 
program. 


2.1   KINDS  OF  SYMBOLS 

The  symbols  that  the  debugger  recognizes  may  be  divided  into  three 
categories:  permanent  symbols,  defined  symbols,  and  program  symbols. 
The  following  three  sections  discuss  these  categories. 

When  you  task-build  with  the  /DA  switch,  the  Task  Builder  creates  a 
symbol  table  (STB)  file  that  lists  all  the  symbols  you  use  in  your 
program.  The  symbol  names  are  associated  with  virtual  addresses  or 
values  and  with  FORTRAN  data  types.  At  run  time,  the  debugger  uses 
the  STB  file  for  syobol  resolution. 

The  STB  file  contains  symbol  records  for  the  following  program 
symbols: 

•  Function  names  (but  not  statement  function  names) 

•  ENTRY  statement  names 

•  Subroutine  names 

•  Variable  names  (but  not  formal  parameter  names) 

At  run  time,  you  can  refer  to  any  of  these  names  symbolically. 

Examples  of  some  valid  program  symbols  are: 

INT4(5) 

C8(5) 

FUNCl 

You  c?:.not  display  the  contents  of  the  STB  file.  You  can,  however, 
determine  if  a  given  symbol  is  in  the  STB  file  by  using  the  EVALUATE 
command.  If  you  ask  the  debugger  to  evaluate  a  symbol  that  is  not  in 
the  STB  file,  you  receive  an  error  message. 
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Under  some  circumstances,  you  have  to  change  the  name  of  the  STB  file. 

This   is   the   case   if   you   move   the  STB  file  from  one  directory  to 

another  or  decide  to  use  an  earlier  version.   To  change   the   name   of 
the  STB  file,  use  the  SET  STB  command  in  the  following  format: 

SET  STB  file-spec 

To  determine  the  name  of  the  c  irrent  STB   file,  issue   the   SHOW   STB 
command. 


2.1 .1   Permanent  Symbols 

You  can  refer  to  the  debugger's  permanent  symbols  at  any  time  during  a 
debugging  sess^^on.  The  following  is  a  list  of  the  debugger's 
permanent  symbols  and  what  they  represent: 


%R0  -  %R5 


%R6  or  %SP 


%R7  or  %PC 


%F0  -  %PS 


General  purpose  registers 
Stack  pointer 
Program  counter 
Floating-point  registers 


%P& 


Processor  status  word 


%FS 


%LINE  nnn 


ISEGMENT  name 


\ 


m 


Floating-point  status  word 

Program  line  number 

Overlay  segment  name 

Current  value  (see  Section  2.3.4} 

Current  location  (see  Section  2.3.5) 

Logical  successor  (see  Section  2.3.7) 

Logical  predecessor  (see  Section  2.3.6) 


2.1.2   Symbols  Created  by  the  DEFINE  command 

During  a  debugging  session,  you  can  create  a  new  symbol  or  change  an 
existing  symbol  by  using  the  DEFINE  command.  The  format  of  the  DEFINE 
command  is: 


line   20   in 


DEFINE  symbol'^address-expression 

In  the  following  example,  the  symbol  catch  is  ciefined  as 
the  main  program  of  the  root  segment  of  the  overlay. 

DBG>DEFINE  catch»%SEGMENT  root\main\%LINE  20 

A  symbol  created  by  the  DEFINE  command  is  destroyed  when  you   end   the 
debugging  session. 
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2.2   MAKING  SYMBOLS  UNAMBIGUOUS 

If  the  program  you  are  debugging  consists  of  more  than  one  prograri 
unit,  you  must  pay  attention  to  the  "scope*  of  symbols  to  which  you 
refer.  In  FORTRAN,  the  scope  o*:  a  symbol  is  the  program  unit  in  which 
the  symbol  is  declared. 

The  default  scop?  is  called  the  PC  scope.  At  the  beginning  of  a 
debugging  session,,  the  PC  scope  is  the  main  unit.  The  PC  scope, 
however,  is  dynamic;  as  you  debug  your  program,  the  PC  scope  is 
always  the  program  unit  you  are  currently  executing. 

If  you  do  not  want  to  use  the  default  scope,  you  can  specify  scope  in 
either  of  two  ways: 

•  Use  a  pathname  in  the  command  line. 

•  Use  a  pathname  with  t's   SET  SCOPE  command. 

These  two  methods  of  specifying  scope  are  discussed  in  the  next  two 
sections. 


2.2.1   Pathnames 

A  pathname  describes  a  program  location.  It  consists  of  program 
location  labels  separated  by  the  backslash  character  (\)  .  A  program 
location  label  may  be  the  name  of  a  module,  the  name  of  a  subprogram, 
a  line  number,  an  array  reference,  or  a  symbol.  The  format  of  a 
pathname  for  a  nonoverlaid  program  is: 

8ub[\%LINE  nnn!\symbol[ (subscript-list) ] ] 

The  pathname  element  sub  is  the  nam^  of  the  subprogram   in  which  the 

symbol   occurs.    The   subscripts   in  the   subscript-list   can  be 

expressions;  all  integers  in  the  subscript-list  are  interpreted  in 
decimal  radix,  regardless  of  the  default  radix  mode. 

Valid  pathnames  for  nonoverlaid  programs  are: 


.MAIN.\ARRMN(12) 
SUB2\%LINE  4 


SUBIXARRI (10,20) 


NOTE 

You  must  always  enter  the  name  of  an 
unnamed  module  (which,  in  FORTRAN,  can 
only  be  a  main  module)  as  ,MAIN.. 
Likewise,  the  debugger  always  displays 
the  name  of  an  unnamed  module  as  .MAIN.. 
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When  you  refer  symbolically  to  a  subprogram,  you  should  specify  the 
name  of  the  subprogram  twice,  with  a  backslash  between  each  occurrence 
of  the  name.  Using  this  format  ensures  that  the  scope  is  correctly 
specified.  For  example,  if  you  are  currently  debugging  SUBl  and  want 
to  set  a  breakpoint  in  SUB2,  the  correct  specification  is 

SET  BREAK  SUB2\SUB2 

If  you  were  to  specify  only  SET  BREAK  SUB2,  the  debugger  would 
interpret  this  as  SET  BREAK  SUB1\SUB2  because  the  default  scope  is 
SUBl. 


A  pathname  may  begin  with  a  backslash  if  the  only  elenient  in  the 
pathname  is  the  symbol  itself,  as  in  the  following  example: 

\NAM$ 

When  a  pathname  begins  with  a  backslash,  the  debugger  ignores  scope 
and  interprets  the  symbol  as  a  global  symbol.  (The  effect  is  the  same 
as  if  you  had  set  the  scope  to  \.)  You  are  roost  likely  to  begin  a 
pathname  with  a  backslash  when  you  are  referring  to  a  sy^i^bol  in  the 
OTS,  where  object  modules  are  compiled  without  the  /DB  or  /DEBUG 
qualifier* 

If  you  are  debugging  a  MACRO-11  program,  you  include  in  a  pathname 
only  a  module  name  and  the  symbol  name,  in  the  following  format: 

mod\symbol 

Symbol  names  in  MACRO-11,  unlike  FORTRAN-77,  can  contain  periods.  If 
you  are  debugging  a  MACRO-11  program  and  want  to  specify  a  symbol  name 
that  contains  periods,  you  must  precede  the  name  with  %NAME  and 
enclose  the  name  in  quotation  marks.  For  example,  to  evaluate  the 
MACRO-11  symbol  A.OR.B,  use  the  following  specification: 

DBG>  EVALUATE  IHAME  "A.OR.B" 


2.2.1.1  Pathnames  in  Overlaid  Prograns  -  The  pathname  syntax  for 
overlaid  programs  is  an  extended  form  of  the  pathname  syntax  for 
nonoverlaid  programs.  Since  it  is  possible  for  a  module  to  appear  at 
more  than  one  place  in  an  overlay  tree,  a  method  of  uniquely 
identifying  the  module  is  required.  The  extended  pathname  syntax 
allows  an  optional  list  of  segment  names  at  the  beginning  of  the 
pathname. 

The  pathname  format  for  an  overlaid  program  is: 

(seg-list] sub(\%LINE  nnn|\symbol [ (subscr ipt-1 ist) ] ] 

The  seg-list  specifies  one  or  more  segment  names,  in  the  following 
format: 

ISEGMENT  name\[%SEGMENT  name\...] 


SEGMENT  may  be  abbreviated  to  SEG. 

If  you  specify  several  segment  names,  they  must  b«  specified  in  the 
order  of  segment  branching,  with  the  segment  name  nearest  the  program 
root  specified  first. 

An  example  of  a  valid  pathname  for  an  overlaid  program  ist 
%SEG  THREE\SUB2\%LINE  4 
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2«2.2  The  SCOPE  Comands 

The  SET  SCOPE  command  establishes  the  specified  program  unit   as   the 

one   to   be   used  for  symbol  interpretation.   The  scope  established  by 

the  SET  SCOPE  command  becomes  the  default  for  all  symbols  specified 
without  a  pathname. 

The  format  of  the  SET  SCOPE  command  is: 
SET  SCOPE  pathname 

The  pathname  may  be  a  scope  prefix  or  the  number  0  or  the  backslash 
character  [\]  . 

A  scope  prefix  may  be  thought  of  as  a  truncated  pathname.  It 
describes  a  location  in  terms  of  its  segment  n-5me  (if  any)  and 
subprogram  name.  A  scope  prefix  does  not  specify  a  particular  line 
number,  array  reference,  or  symbol,  as  does  a  pathname.  The  format  of 
a  scope  prefix  is:  ^ 

[seg-list] sub 

The  following  example  uses  a  scope  prefix  with  the  SET  SCOPE  command 
to  tell  the  debugger  to  interpret  all  symbols  as  lying  within  the  main 
program  in  the  root  segment. 

SET  SCOPE  %£EG  ROOT\,MAIN. 
The  command 

SET  SCOPE  0 
sets  the  scope  to  the  currently  active  program  unit. 
The  command 

SET  SCOPE  \ 

interprets  symbols  without  pathnames  as  global  symbols.  A  global 
symbol  is  any  symbol  defined  by  a  MACRO-U  double  colon  (::)  or  double 
equal  sign  (=») ,  as  well  as  all  FORTRAN-77  subprogram  names  and  the 
ENTRY  statement.  You  are  most  likely  to  set  the  scope  to  \  when  you 
want  to  refer  to  symbols  that  occur  in  a  program  compiled  without  the 
/DB  or  /DEBUG  qualifier. 

To  determine  the  current  scope,  use  the  command 


use   the 


SHOW  SCOPE 

To  cancel  the  scope  established  by  the   SET  SCOPE  command, 
command 

CANCEL  SCOPE 

AS  a  result  of  the  CANCEL  SCOPE  command,  symbols  without  scope 
prefixes  are  interpreted  as  if  they  occurred  in  the  current  program 
unit,  that  is,  the  program  unit  containing  the  PC.  The  CANCEL  SCOPE 
command  is  equivalent  in  effect  to  the  command  SET  SCOPE  0. 


2.3   ADDRESSES 

This  section  presents  each 
debugger   interprets   it. 


form  of 
You   can 


address  and   explains  how  the 
refer   to   an  address  by  program 
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symbol,  defined  symbol,  line  number  or  other  permanent  symbol,  a 
literal,  the  current  value  or  location,  logical  predecessor  or 
successor,  and  address  expression. 

The  debugger  interprets  and  displays  all  addresses  according  to  the 
rules  for  determining  mode  (see  Section  4.1)  and  type  (see  Section 
4.2). 


2.3.1   Reference  b>  Progran  Symbol  or  Defined  Symbol 

One  type  of  symbolic  reference  uses  either  a  program  symbol  or  a 
defined  symbol  to  refer  to  a  program  location.  The  symbol  may  or  may 
not  have  a  pathname  (see  Section  2.2.1). 

In  the  following  example,  the  symbolic  reference  A(5)  is  a  program 
symbol  and  SUB1\ANS  is  a  pathname  that  contains  the  defined  symbol 
ANS. 

DBG> EXAMINE  A(5) 
DBG> EXAMINE  SUB1\ANS 


2.3.2   Line  Numbers  and  Other  Permanent  Symbols 

In  a  debugging  session,  you  can  use  line  numbers  generated  by  the 
compiler  to  refer  to  lines  of  code  in  the  source  program.  The  line 
number  must  be  preceded  by  a  percent  sign  (%) .  When  the  debugger 
encounters  the  %LINE  symbol,  it  interprets  the  following  number  as  a 
compiler-generated  line  number  and  uses  it  as  a  simple  address  to 
refer  to  that  location.   For  example: 

DBOSET  BREAK  %LINE  221 

The  debugger  always  interprets  a  line  number  as  a  decimal  number. 

You  may  also  use  a  line  number  with  a  pathname  as  a  simple  address. 
The  pathname  must  precede  the  entire  line  number  notation,  as  follows: 

EXAMPLMLINE  28 

A  reference  to  a  register,  the  stack  pointer,  the  program  counter,  or 
a  status  word  must  also  be  preceded  by  a  percent  sign.  Section  2.1.1 
lists  all  the  ^/mbols  that  require  the  percent  sign. 


2.3.3   Literals 

A  literal  is  any  character  string  that  is  a  constant  but  is  not  a 
symbol.  The  debugger  supports  firee  kinds  of  literals:  integer, 
floating  point,  and  quoted  string.  When  interpreting  an  address 
•xp^'ession,  the  debu^jqer  converts  a  float  ing-poin^  literal  to  an 
ini   er. 


A  numeric  literal  used  as  a  simple  address  denotes 
address,  as  in  the  following  example: 

DBG>EXAMINE  6042 


a   virtual   memory 


A  numeric  literal  may  also  be  used  as  an  affaat  from  a  program 
location;  the  direction  of  the  offset  is  indicated  by  the  positive  or 
aegative  sign  of  the  number. 


2-6 


THE  DEBUGGER'S  SYMBOLIC  CAPABILITIES 

Addresses 


In  the  following  example,  the  literal  4  denotes  a  4-byte  offset  from 
the  memory  address  represented  by  OPT;  the  value  of  X,  interpreted  as 
a  byte  integer,  is  deposited  in  the  location  specified  by  the  address 
expression  0PT-»'4, 

DBODEPOSIT/BYTE   0PT-K4  =  X 


2.3.4  Current  Value 


The  backslash  (\)  is  the  current  value  symbol.  It  represents  the  last 
value  displayed  by  an  EVALUATE  command.  At  debugger  start-up.  its 
value  is  0. 

The  backslash  is  also  used  to  separate  the  components  of  a  pathname 
(see  Section  2.2.1)  and  as  a  type  of  scope  (see  Section  2.2). 


2.3.5  Current  Location 

The  period  (.)  is  the  current  location  symbol.  The  current  location 
is  egual  to  the  last  address  examined  with  the  EXAMINE  command  or 
deposited  into  with  the  DEPOSIT  command.  At  debugger  start-up,  its 
value  is  0. 


The  following  example  sets  the  current  location  to  24   because 
the  start  of  the  last  word  examined  (default  type  here  is  WORD) 


24   is 


EXAMINE  12:25 


The  debugger  interprets  the  current  location  in  the  type  associated 
with  the  address  expression  in  the  EXAMINE  or  DEPOSIT  command  that  set 
the  current  location. 


2.3.6   Logical  Predecessor 

The  circumflex  D  is  the  logical  predecessor  symbol.  You  use  the 
logical  predecessor  symbol  with  the  EXAMINE  and  DEPOSIT  commands  to 
refer  to  the  next  lower  address  from  the  current  location. 

The  logical  predecessor  is  defined  only  for  elements  of  arrays, 
untyped  storage  locations,  instructions,  and  PDP-11  machine  registers. 

When  interpreting  the  logical  predecessor  symbol,  the  debugger  js-s 
the  type  and  mode  information  associated  with  the  current  location. 


2.3.7   Logical  Successor 

The  RETURN  key  is  the  logical  successor  symbol.  You  use  the  logical 
successor  symbol  with  the  EXAMINE  and  DEPOSIT  commands  to  refer  to  the 
next  higher  address  from  the  current  location. 

The  logical  successor  is  defined  only  for  elements  of  arrays,  untyped 
storage  locations,  instructions,  and  PDP-il  machine  registers. 

Wh^n  interpreting  the  logical  successor  symbol,  the  debugger  uses  the 
type  and  mode  information  associated  with  the  current  location. 
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2.3.8   Address  Expressions 

An  address  expression  may  consist  of 
address)  or  of  several  operands 
delimiters. 


a   single  operand   (a  simple 
together  with  operators  and 


In  computing  the  value  of  an  address  expression^  the  debugger  uses  the 
address  of  the  specified  location^  not  the  contents  of  the  location 
denoted  by  the  symbol.  The  result  of  evaluating  an  address  expression 
is  a  16-bit  word  integer. 

The  following  are  legal  operators  and  delimiters  in  address 
expressions.  The**  are  listed  in  order  from  highest  precedence  to 
lowest: 

•  Parentheses  ((  )) 

•  Unary  minus  (-) 

•  Multiplication  (*)  and  division  (/) 

•  Plus  (+)  and  minus  (-) 

The  operands  in  an  address  expression  may  be  integers,  defined 
symbols,  program  symbols,  register  names,  line  numbers,  or  the  current 
location  symbol . 


2.4   VALUE  EXPRESSIOKS 

Value  expressions  »Tiay  be  specified  with  the  DEPOSIT  and  EVALUATE 
commands.  in  computing  the  value  of  a  value  expression,  the  debugger 
replaces  any  defined  symbol  or  program  symbol  with  the  value  stored  in 
the  location  denoted  by  the  symbol.  These  values  have  the  type 
associated  with  the  location.  Integers  used  in  a  value  expression  are 
interpreted  as  values,  not  addresses. 

The  following  are  legal  operators  and  delimiters  in  value  expressions. 
They  are  listed  in  order  from  highest  precedence  to  lowest. 

•  Parentneses  ((  )) 

•  Unary  minus  (-) 

•  Multiplication  (*)  i.nd   division  (/) 

•  Plus  (-♦-)  and  minus  (-) 

•  The  logical  operators  .GT.,  .LT.,  .GE.,  .LE.,  .EQ.,  .NE. 

•  The  logical  operator  .NOT. 

•  The  logical  operator  .AND. 

•  The  logical  operator  .OR. 

•  The  logical  operators  .XOR.,  .EQV. 
A  value  expression  may  be  a  quoted  string. 
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2.5   THE  EVALl'ATE  COMMAMD 

You  can  use   the   EVALUATE   command   to   evaluate   either   an 
expression  or  a  value  expression,  in  the  following  format: 


address 


EVALUATE [/qualifier...]  expression 

If  you  specify  the  /ADDRESS  qualifier,  the  debugger  displays  the 
address  expression  as  a  virtual  address.  Otherwise,  the  debugger 
assumes  that  the  specified  expression  is  a  value  expression. 

You  can  specify  a  radix  mode  qualifier  (/BINARY,  /DECIMAL,  /OCTAL, 
/HEXADECIMAL)  with  the  EVALUATt:  command.  If  you  do  so,  the  debugger 
interprets  integers  in  the  expression  in  the  specified  radix  and 
displays  the  value  of  che  expression  as  a  literal  in  that  radix. 

It  is  an  error  to  evaluate  an  expression  that  contains  values  not 
currently  resident. 

An  example  of  the  use  of  the  EVALUATE  command  follows: 

DBG> EVALUATE/ADDRESS  15346 

15346 

DBOEXAMINE  15346 

15346:   6083 

DBODtFINE    X    =     1534€ 

DBG> EVALUATE    X 

6083 

DBG> EVALUATE/ ADDRESS  X 

15346 

You  can  also  use  the  EVALUATE/ADDRESS  command  to  perform  address 
arithmetic,  ds  in  the  following  examples: 

DBG> EVALUATE/ADDRESS  10  24  ♦  40 
1064 


DBG> EVALUATE/ADDRESS  (X  *  2)/2 
7674 

DBG>E:XA«INE  7674 
If^i:         8350 

You  must  use  the  legal  operators  and  deli.niters  as  defined  in   Section 
2.3.8. 
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CHAPTER  3 


CONTROLLING  PROGRAM  EXECUTION 


3.1   STARTING  AND  STOPPIIfC  PROGRAM  EXECUTION 

To  begin  progran  execution  at  debugger  start-up  or  to  resume  execution 
after  it  has  b /en  suspended,  you  use  the  GO  command.  The  GO  command 
causes  /our  |:  ogram  to  be  executed  until  one  of  the  following  occurs: 

•  Your  program  terminates* 

•  A  breakpoint  is  encountered. 

•  A  pending  STEP  sequence  is  completed. 

•  An  error  is  detected. 

•  You  issue  a  CTRL/Y  or  CTRl/C. 

When  you  use  the  GO  command  a*:  debugger  start-up,  execution  begins  at 
the  transfer  address. 

When  you  use  the  GO  command  to  resume  program  execution  after 
suspension,  execution  resumes  at  the  current  program  counter  location, 
as  in  the  following  example: 

DBG>SET  BREAK  ILINE  5 

DBG>SET  BI^EAK  ILINE  6 

DBG>GO 

routine  start  at  EXAMPL 

IKQOOOO 
breakpoint  at  SORTMLINE  5 
DBG>GO 

start  at  SORTMLINE  S 
breakpoint  at  SORTMLINE  6 

You  can  specify  an  address  with  the  Q\}  command,  but  you  should  be 
cautious  if  you  do  it  because  the  00  command  does  not  alter  register 
contents  or  the  system  stack;  it  simply  transfers  control  to  the 
designated  location.  Thuib,  if  the  program  state  at  the  specified 
address  is  not  the  same  as  the  program  state  t#hen  you  issue  the  GO 
coi^and,  the  results  may  he  unpredictable. 


If  you  attempt  to  issue   the   GO   command 
location,  an  error  is  reported. 


at   a   nonresident   program 


To  jnd  a  debugging  session,  issue  the  EXIT  command  or  enter  CTRL/Z. 
After  you  terminate  y<^ur  program,  you  cannot  continue  the  debugging 
session  by  issuing  the  DCL  command  DEBUG.  To  restart  the  debugger, 
you  must  run  tht  program  again. 
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You  should  not  let.  the  debugger  run  past  the  end  of  the  user  program. 
For  this  reason,  it  is  wise  to  set  breakpoints  on  critical  code  paths 
to  nake  sure  you  can  regain  control.  It  is  also  good  practice  to  set 
a  breakpoint  on  return  froa  the  main  routine. 

Section  1.2.5  discusses  whe  effects  of  interrupting  a  program  with 
•ither  CTRL/C  or  CTRL/Y. 


3.2   STEPPING  THROUGH  A  PROGRAM 

When  you  want  to  execute  your  program  a  portion  at  a  time,  you  can  use 
the  STEP  command.  With  the  STEP  command,  you  can  execute  a  single 
line  or  instruction,  or  a  group  of  lines  or  instructions.  You  can 
also  choose  to  step  "into*  or  "over"  called  routines  in  your  program. 

By  default,  the  debugger  steps  by  line  and  over  called  routines. 

When  you  issue  a  STEP  coMiand,  the  debugger  does  the  following: 

1.  Reports  the  next  lina  or  instruction  to  be  executed 

2.  Executes  one  or  more  lines  or  instructions 


3.   Reports  the  line  or  instruction  that  follows  the  last  line  or 
instruction  executed 


4.   Issues  its  prompt 

The  following  example  ^hows  a  step  from  line  9  to  line  10 
Line  9  is  the  current  location. 


of   MYPROG. 


1>STEP 

start  at  MYPROGMLINE  9 
stepped  to  MYPROGMLINE  10 

If  you  want  to  execute  more  than  one  line   or   instruction,   you   must 
specify  a  decimal  integer  as  a  step  count,  in  the  following  format: 

STEP[/qual if ier t/qual if ier]  1  [step-countj 

The  following  example  shows  how  to  specify  that  four   instructions   be 
executed: 


>ST£P/INSTR  4 

A  STEP  condition  (that  Is,  stepping  by  instruction  or  line,  Into  or 
over  routines)  specified  as  a  qualifier  to  the  STEP  command  overrides 
the  effects  of  a  SET  STEP  command.  Section  3.2.1  discusses  the  SET 
STEP  command. 


3*2.i   Changing  the  Default  Step  Conditions 

Unless  you  specify  otherwise,  the  debugger  steps  by  line  through  your 
program  and  steps  over  any  called  routines.  You  can  use  the  SET  STEP 
command  to  change  the  default  step  conditions;  the  SET  STEP  command 
establishes  the  step  conditions  that  the  debugger  uses  whenever  a  STEP 
command  Is  Issued  without  a  command  qualifier. 

The  format  of  the  SET  STEP  command  follows: 

SET  STEP  condition  t, condition) 
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Note  that  a  step  condition  specified  as  a  qualifier  with  the  STEP 
coniDand  overrides,  while  the  command  is  in  effect,  any  STEP  conditions 
established  by  the  SET  STEP  command.  To  display  the  current  step 
conditions,  issue  the  command 

SHOW  STEP 

To  restore  step  conditions  to  the  default,  issue  the  command 

CANCEL  STEP 


3 .2 .2   The  STEP  Sequence 

When  you  issue  a  STEP  command,  the  debugger  continues  executing  your 
program  until  one  of  the  following  occurs: 

•  Any  STEP  sequence  Is  complete. 

•  A  breakpoint  or  tracepoint  occurs. 

•  An  error  is  detected  in  your  program. 

•  Your  program  completes  e«(ecution. 

A  STEP  sequence  is  considered  cowiplete  only  when  the  specified  number 
of  lines  or  instructions  has  been  executed,  regardless  of  intervening 
events.  Therefore,  if  the  debugger  encounters  a  breakpoint  or 
tracepoint  while  executing  a  STEP  sequence,  execution  of  the  STEP 
sequence  is  merely  suspended,  not  completed.  Execution  of  the 
incomplete  STEP  sequence  resumes  when  a  GO  command  or  another  STEP 
command  is  issued. 

Thus,  any  number  of  STEP  sequences  may  be  in  effect  at  any  one  time; 
the  sequences  are  executed  independently  and  simultaneous!".  If 
multiple  STEP  sequences  are  completed  at  the  same  time,  the  debugger 
Issues  a  message  for  each  completed  sequence. 

The  following  examples  of  step  sequences  apply  to  the  example  program 
in  Appendix  A. 


Examples 

i.         DBOSET  BREAK  ILINE  7 
DBOGO 

routine  start  at  EXAMPL 
breakpoint  at  EXAMPLEMLINB  7 
DBOSET  BR  ILINE  8 
DBOSTEP  J 

start  at  EXAMPLMLINE  7 
breakpoint  at  EXAMPLMLINE  8 
DBG>GO 

start  at  EXAMPLMLINE  8 
stepped  to  EXAMPLMLINE  10 


Because  the  breakpoint  at  line  8  was  activated  after  only  one  line   of 

the   STEP   3   sequence   had  been  ej^ecuted,  the  step  sequence  continues 

vhen  the  GO  command  is  executed.  The  step  sequence  starts  at   line   7 
and  finishes  at  line  10. 
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%LINE  6 


at  EXAMPL 
EXAMPLMLINE  6 


2.         DBG>SET  BR 
DBOSTEP  5 
routine  start 
breakpoint  at 
DBOSTEP  2 

start  at  EXAMPL\%LINE  6 
stepped  to  £XAMPL\%LINE  8 
DBG>GO 

start  at  EXAMPL\%LINE  8 
stepped  to  EXAMPL\%LINE  10 


The  STEP  5  sequence  starts  at  EX^?^PL   and 
executable  lines  count  in  a  step  sequence. 
the  first  executable  line,  which  is   Tine 
starts   at   line   6   and  ends  at  line  8.   Thus, 
began  first  finished  last. 

3.    DBOSET  BR  %LINE  8 
DBOSTEP  4 

routine  start  at  EXAMPL 
breakpoint  at  EXAMPLMLINE  8 
DBOSTEP/INSTR  4 
start  at  EXAMPLMLINE  8 
stepped  to  EXAMPL\%LINE  8  -»-  16 :   MOV 
DBOGO 

start  at  EXAMPLMLINE  8  ♦  16 
stepped  to  EXAMPL\%LINE  9 


ends   at 

It  takes 
6.) 


line   10.    (Only 
one  step  to  reach 
The   .STEP   2   sequence 
the  step  sequence  that 


%R1,-(%SP) 


The  STEP  4  sequence  starts  at  "line  0"  and  ends  at  line  9.  It  is 
interrupted  by  the  breakpoint  at  line  8  and  is  executed  concurrently 
with  the  STEP/INSTR  4  sequence.  The  STEP/INSTR  4  sequence  starts  at 
line  8  (which  contains  8  instructions)  and  ends  after  the  fourth 
instruction  is  executed.  Because  the  A  instructions  require  16  bytes, 
the  debugger  steps  to  the  beginning  of  the  seventeenth  byte  of  line  8, 
After  the  GO  command  is  issued,  the  STEP  4  sequence  finishes. 

4.    DBG>SET  BR  SORT\SORT 
DBG>STEP  3 

routine  start  at  EXAMPL 
routine  breakpoint  at  SORT 
DBOSTEP  4 

routine  start  at  SORT 
stepped  to  SORTMLINE  6 
DBG>GO 

start  at  S0RT\%LINE  6 
stepped  to  EXAMPL\%LINE  8 


The  STEP  3  sequence  starts  at  "line  0^  and  finishes  at  line  8,  but  \a 
interrupted  by  the  breakpoint  at  the  beginning  of  subroutine  SORT. 
(SORT  is  specified  as  S0RT\S0RT  rather  than  just  SORT  because  the 
debugger  would  interpret  SORT  as  0\SORT  —  that  is,  2XAMPL\S0RT,  not 
the  correct  specification.)  The  STEP  4  sequence  starts  at  the 
breakpoint,  is  executed  inside  the  subroutine,  and  finishes  at  line  6 
of  the  subroutine.  The  GO  command  causes  execution  to  resume  until 
the  STEP  3  sequence  finishes.  The  entire  call  to  SORT  counts  as  a 
single  step. 
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3.)   SUSPENDING  PROGRAM  EXECUTION 

At  certdin  points  In  your  program,  you  nay  want  to  suspend  execution 
so  you  can  examine  or  modify  variables  or  arrays.  To  do  this,  use  the 
SET  BREAK  command  to  establish  breakpoints  in  your  program. 


A  breakpoint  is  a  program  location  at 
following: 

1*   Suspends  program  execution 


which   the  debugger   does   the 


2.  Displays  the  name  or  the  virtual  location  at  which   execution 
has  been  suspended 

3.  Executes  commands  in  a  DO  sequence  if  one   was   specified   in 
the  SET  BREAK  command 


4.   Issues  its  prompt 

When  a  breakpoint  is  activated,  program  execution  is  suspended 
the  instruction  at  the  breakpoint  is  executed. 


before 


To  set  a  breakpoint,  issue  the  SET  BREAK  command  in  the  following 
format: 

SET  BREAK  [/qual I f ier . . . 1 [ addf-expr  [WHEN (value-expr) ) (DO(act ion) ) 1 

The  qualifiers  you  can  use  with  the  SET  BREAK  command  are  /AFTERm, 
/RETURN,  and  /CALLS.  You  must  specify  either  an  address  expression  or 
/CALLS,  but  not  both.  The  /CALLS  qualifier  sets  a  breakpoint  at  all 
JSR  and  RTS  instructions.  If  you  specify  /CALLS,  it  must  be  the  only 
qualifier. 

If  you  specify  the  /APTER:n  qualifier,  the  debugger  takes  break  action 
at  the  nth  activation  of  the  specified  location.   See  Section  3.4.1. 

If  you  specify  a  WHEN  value  expression,  the  breakpoint  is  not 
activated  unless  the  valu;^  expression  is  true.   See  Section  3.4.2. 

If  you  specify  a  DO  action,  the  debugger  executes  commands  in  the 
action  when  the  breakpoint  is  activated.   See  Section  3.4.3. 


For  the  breakpoint  to  be  activated,  two  conditions  must  be  ret:  The 
WHEN  value  expression  must  be  true,  and  the  current  'AFTERm  count 
must  be  either  I  or  0.  (/AFTERiO  is  a  special  case.  See  Section 
3.4.1  for  more  information.)  The  message  that  a  breakpoint  has  been 
reached  does  not  appear  until  both  these  conditions  have  been  met. 

If  you  use  a  virtual  memory  address  or  an  address  expression  whose 
value  is  not  a  symbolic  location  as  a  parameter  with  the  SET  BREAK 
command,  you  should  check  that  an  instruction  actually  begins  at  th** 
byte  of  memory  so  indicated.  I^  an  instruction  does  not  begin  at  this 
byte,  a  run-time  error  may  occur  when  an  instruction  including  that 
tyte  is  executed. 

When  a  routine  name  is  the  parameter  in  a  SET  BREAK  command,  the 
debugger  notes  this  fact  when  the  breakpoint  is  activated  by  issuing 
the  following  message: 

rouv.  ne  break  at  routine  name 
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To  see  what  breakpoints  are  in  effect^  issue  the  command 

SHOW  BREAK 

Once  set,   a   breakpoint   remains  active   for   the  duration  of   th' 
debugging   session  unless  you  cancel  it  with  the  CANCEL  BREAK  command, 
or  set  another  breakpoint  or  a  tracepoint  at   that   program   location. 
In   that   case,  the  old  breakpoint  specification  is  overwritten;   that 
is,  the  old  breakpoint  is  canceled. 

The  format  of  the  CANCEL  BREAK  command  is: 

CANCEL  BREAK  [/qual if ier ] [addr-expr] 

If  you  specify  an  address  expression,  you  have  the  option  of 
specifying  /RETURN.  If  you  specify  the  /ALL  qualifier,  you  cannot 
also  specify  an  address  expression. 


3.3.1   Disabling  and  Enabling  Breakpoints 

To  disable  all  breakpoints,  issue  the  DISABLE 
DISAB^E  command  does  not  cancel  breakpoints; 
b€i»».j  jC  :ivated  until  you  enable  them. 


BREAK  command.    The 
it  prevents  them  from 


To  ei  ibJ   disabled  breakpoints,  use  the  ENABLE  BREAK  command.   You 
not  h^7»j   o  respecify  breakpoints  when  you  use  the  ENABLE  command. 


do 


iif  f 
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ODIFYING  THE  SET  BREAK  AND  SET  TRACE  COMMANDS 


Tne  ollowing  three  sections  discuss  three  modifiers  to  the  SET  BREAK 
and  SET  TRACE  commands.  These  modifiers  function  the  same  way  for 
eich  command.  They  are  the  /AFTER:n  qualifier,  the  WHEN  value 
expression,  and  the  DO  action. 

Breakpoints  and  the  SET  BREAK  command  are  discussed  in  Section  3.3. 

Tracepoints  and  the  SET  TRACE  command  are  discussed  in  Section  3.5.1. 


e 


3.4.1   The  /AFTER:n  Qualifier 

By  using  /AFTERrn  as  a  qualifier  with  either  the  SET  BREAK  or  SET 
TRACE  command,  you  direct  the  debugger  to  count  but  not  break  or  trace 
at  the  first  n-1  activations  of  the  specified  location.  The  debugger 
takes  break  or  trace  action  only  on  the  nth  and  subsequent  activations 
of  that  location. 

For  example,  as  a  result  of  the  following  command,  a  breakpoint  occurs 
on  the  10th  activation  of  CHEK: 


DBOSET  PREAK/AFTER:10   CHEK 

All  subsequent  activations  of  CHLK  —  the  11th  activation,  the  12th, 
and  so  on  —  result  in  breakpoints. 

You  u«#»  the  /AFTFRtO  nu=illfier  if  you  want  the  breakpoint  or 
tracepoint  to  be  canceled  immediateiy  atter  its  tirsu  activation. 
Thus,  /AFTER:0  has  the  same  effect  as  /AFTER:!  except  that  /AFTERiO 
cancels  the  breakpoint  or  tracepoint  after  activation. 
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^.4.2   Using  th«  NHEN  VaAue  Expression 

The  WHEN  value  expression  is  a  lo9lcal  expression  that  yoa  can  ase  to 
conditionally  set  a  breakpoint  or  trace^int.  You  specify  it  in  the 
following  fomat  (with  either  the  SET  BREAK  or  SET  TRACE  comnand)  : 

SET  BREAK  addr-expr  [WHEN (val ae-expr) 1 (DO(act ion) ] 

For  he  breakpoint  or  tracepoint  to  be  activated,  the  value  expressitn 
must  be  tru«.  You  may  use  the  MHEN  value  expression  with  or  without 
the  DO  action,  which  is  discussed  in  Section  3.4.3. 


The  value  expression  nay  be  any  logical  expression  that   is   valid 
FORTRAN.   See  Section  3.4.3  for  an  example  that  uses  WHEN. 


m 


3.4.3   The  DO  Action 

If  you  want  the  debu99er  to  execute?  one  or  more  debugger  commands  when 
a  breakpoint  or  tracepoint  is  activated,  you  specify  these  commands  in 
a  DO  command  sequence  in  the  following  tornat  (with  either  the  SET 
BREAK  or  SET  TRACE  command} : 


SET  BREAK  addr-expr  {WHEN (val ue-expr )  1  [DOlaction) ] 

The  action  may  be  a  single  command,  a  list  of  commands,  or  a  command 
procedure.  Parentheses  are  required  delimiters  and  the  commands  must 
be  separated  by  a  semicolon  (;)^ 

If  you  want  the  DO  action  to  be  executed  only  under  certain 
conditions,  you  can  use  the  WHEN  value  expression  to  specify  these 
conditions.  The  value  expression  is  evaluated  when  the  location  is 
reached,  but  before  the  breakpoint  or  tracepoint  is  activated.  The 
value  of  the  value  expression  may  be  either  true  or  lalse.  If  the 
value  is  false,  the  breakpoint  or  tracepoint  is  not  activated  and  the 
DO  action  is  not  executed. 

The  debugger  executes  commands  In  a  DO  action  in  the  order  in  which 
they  are  listed.  Any  debugger  command,  including  a  SET  BREAK  or  SET 
TRACE  command  with  a  DO  action,  may  appear  in  a  DO  action.  Nesting  of 
DO  actions  is  permissible  to  any  level. 

Note  that  the  debugger  does  not  check  the  syntactical  correctness  of 
the  DO  action  when  you  issue  the  command  containing  the  DO  action; 
rather,  the  debugger  checks  syntactical  correctness  when  it  actually 
executes  the  DO  action. 

The  following  example  demonstrates  a  WHEN... DO  sequence: 

SET  BR  ILINE  30  WHEN  (N  .GT.  10  .AND.  BIG  .EQ.  TRUE)  DO  (EV  X;EV  Z ; EV  Y) 


3.5   MONITORING  PROGRAM  EXECUTION 

This  section  discusses  how  to  monitor  program  execution  by  tracing  th< 
flow  of  program  control  and  by  displaying  the  current  state  of  routine 
calls. 
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3«S«1   Tracepoints 

By  setting  tracepoints,  you  can  monitor  the  sequence  in  which 
instructions  in  your  program  are  executed  and  thereby  check  for 
unexpected  control  transfers.  When  a  tracepoint  is  activated,  the 
debugger  does  the  following: 

!•   Suspends  execution  at  the  traced  location 

2.   Reports  that  execution  has  reached  the  traced  location 

3*   Executes  commands  in  a  DO  sequence  if  one  was  specified   in 
the  SET  TRACE  command 

4*   Resumes  execution  at  the  current  program  counter 

To  set  a  tracepoint,  issue  the  SET  TRACE  command  in  the  following 
format: 

SET  TRACE  [/qual  if  ier  . . .  1  [addr -expr  [WHEN  (value-expr)  HDO(action)  ]  ] 

The  qualifiers  you  can  use  with  the  SET  TRACE  command  are  /AFTER: n, 
/RETURN,  and  /CALLS.  You  must  specify  either  an  address  expression  or 
/CALLS,  but  not  both.  The  /CALLS  qualifier  sets  a  tracepoint  at  all 
JSR  and  RTS  instructions.  If  you  specify  /CALLS,  it  must  be  the  only 
qiialifier. 

If  you  specify  the  /AFTER:n  qualifier,  the  debugger  takes  trace  action 
at  the  nth  activation  of  the  specified  location.   See  Section  3.4.1* 

If  you  specify  a  WHEN  v^ilue  expression,  the  tracepoint  is  not 
activated  unless  the  value  expression  is  true.   See  Section  3.4.2. 

If  you  specify  a  DO  action,  the  debugger  executes  commands  in  the 
action  when  the  tracepoint  is  activated.   See  Sec^ ion  3.4.3. 

For  the  tracepoint  to  be  activated,  two  conditions  must  be  met:  The 
WHEN  value  expression  must  be  true,  and  the  current  /AFTER:n  count 
must  be  either  0  or  1.  The  message  that  a  tracepoint  has  been  reached 
does  not  appear  until  both  these  conditions  have  been  met. 

To  see  what  tracepoints  are  in  effect,  issue  the  command 

SHOW  TRACE 

Once  set,  a  tracepoint  remains  active  ,for  the  duration  of  the 
debugging  session  unless  you  cancel  it  with  the  CANCEL  TRACE  command 
or  set  another  tracepoint  at  that  program  location.  In  that  case,  the 
old  tracepoint  specification  is  overwritten;  that  is,  no  tracepoint 
is  set. 

The  format  of  the  CANCEL  TF.ACE  command  Is^ 

CANCEL  TRACE  t/qual i f ier] [ addr-expr] 

If  you  specify  an  address  expression,  you  have  the  option  of 
•  pfrcifying  /RETURN.  If  you  specify  the  /ALL  qualifier,  you  cannot 
alto  specify  an  address  expression. 


3.5*2  Disabling  and  Enabling  Tracepoints 

To  disable  all  tracepoints,  issue  the  DISABLE 
DISABLE  co«>mand  does  not  cancel  tracepoints; 
being  activated  until  you  enable  them. 
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To  enable  disabled  tracepoints,  use  the  ENABLE  TRACE  command.   You 
not  have  to  respecify  tracepoints  when  you  use  the  ENABLE  command* 


do 


3 .5 .3   The  SHOW  CALLS  Connand 

The  SHOW  CALLS  command  provides  information  about  the  sequence  of 
currently  active  subprogram  calls  or  the  number  of  calls  on  the  stack. 
Only  programs  compiled  with  /TR;NAMES,  /TR:BLOCKS,  or  /TRiALL  provide 
SHOW  CALLS  information.  Since  /TR:BLOCKS  is  the  default  switch,  your 
program  will  supply  traceback  information  unless  you  specify  otherwise 
at  compile  time. 

The  format  of  the  SHOW  CALLS  command  is: 
SHOW  CALLS  [call-count] 

The  optional  parameter  call-count  is  a  decimal  integer  in  the  range  0 
through  32767  that  specifies  the  number  of  calls  to  be  displayed.  If 
you  do  not  specify  the  call  count,  or  if  the  call  count  exceeds  the 
current  number  of  calls,  information  on  all  calls  is  displayed.  If 
the  call  count  is  0,  the  command  is  accepted  but  no  information  is 
displayed. 


Each  line  of  information  displayed  by  the  debugger  contains: 

•  The  name  of  the  module  that  called  the  routine. 

•  The  name  of  the  called  routine. 

•  The  line  number  of  the  call. 

•  The  value  of  the  PC  in  the  calling  routine  at  the  time  that 
control  was  transferred  to  the  called  routine.  Note  that  this 
value  is  the  location  of  the  instruction  following  the  call. 
The  value  of  the  PC  is  expressed  in  two  wr^ys:  as  an  absolute 
virtual  address,  and  as  a  virtual  address  relative  to  the 
virtual  address  of  the  name  of  the  routine. 

The  following  example  demonstrates  the  use  of  the  SHOW  CALLS  command: 

DBOSET  BR  sub3\%line  5 

DBOGO 

routine  start  at  .MAIN. 

breakpoint  at  SUB3\%LINE  5 

DBOSHOW  CALLS 


auie  name 

routine  name 

1  ine 

rel  PC 

abs  PC 

SUB3 

SUB3 

S 

000036 

060326 

THREE 

THREE 

t 

000064 

060224 

ONE 

ONE 

14 

000134 

057674 

•MAIN. 

.MAIN. 

24 

000262 

002602 

In  the  above  example,  SUB3  is  the  subprogram  that  is  currently  being 
executed.  SUB3  was  called  by  THREE,  THREE  was  called  by  ONE,  and  ONE 
was  called  by  MAIN. 
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The  following  example  demonstrates  a  case 
SHOW  CALLS  command  can  be  misleading: 


in  which  the  results  of   the 


sub3\sub3 
sub3\%line  5 


DBOSET    BR 

DBOSET    BR 

DBOGO 

routine  start  at  .MAIN. 

breakpoint  at  SUB3\SUB3 

DBOSHOW  CALLS 

module  name   routine  name   line 


SUB3 

ONE 

.MAIN. 


SUB3 

ONE 

.MAIN 


14 
24 


rel  PC 

000000 
000134 
000262 


abs  PC 

060270 
057674 
002602 


DBOGO 

routine  start  at  SUB3\SUB3 
breakpoint  at  SUB3\%LINE  5 
DBOSHOW  CALLS 


dule  name 

routine 

name 

line 

rel  PC 

abs  PC 

SUB3 

SUB3 

5 

000036 

060326 

THREE 

THREE 

9 

000064 

060224 

ONE 

ONE 

14 

000134 

057674 

.MAIN. 

.MAIN, 

1 

24 

000262 

002602 

Note  that  two  breakpoints  have  been  set:  one  at  the  beginning  of 
SUB3r  and  another  five  lines  into  SUB3.  When  the  first  breakpoint  is 
reached,  the  results  of  the  SHOW  CALLS  command  indicate  that  SUB3  was 
called  by  ONE,  which  is,  in  fact,  not  true.  The  SHOW  CALLS  command 
issued  after  the  second  breakpoint  (five  lines  into  SUB3)  indicates 
that  SUB3  was  called  by  THREE.   This  information  is  correct. 

The  reason  for  t\  discrepancy  is  that  several  instructions  intervene 
between  the  ins  action  that  calls  the  routine  (in  this  case,  SUB3) 
and  the  instruct: ^n  that  puts  the  name  of  the  calling  routine  (in  this 
case,  THREE)  on  the  traceback  list.  Thus,  until  you  have  issued  a 
STEP  or  GO  command  that  takes  you  past  the  instruction  that  puts  the 
calling  routine  on  the  traceback  list,  the  debugger  will  not  have 
current  information. 

This  problem  occurs  only  when  a  breakpoint  is  set  at  a  routine.  You 
can  overcome  the  problem  by  setting  an  additional  breakpoint  within 
the  routine,  or  by  stepping  over  at  least  four  instructions  after  the 
routine  breakpoint  before  issuing  a  SHOW  CALLS  command. 

One  of  the  specific  uses  for  the  SHOW  CALLS  command  occurs  when  you 
receive  an  error  message  from  an  OTS  routine.  Because  the  debugger 
reports  the  actual  address  where  the  error  occurred  (within  the  OTS) , 
it  is  not  obvious  which  FORTRAN  source  line  is  associated  with  the 
error.  You  can  use  the  SHOW  CALLS  command  to  display  the  name  of  the 
FORTRAN  subprogram  that  called  the  OTS  routine. 


3.5.4   The  SHOW  ALL  and  CANCEL  ALL  Commands 

When  you  issue  the  SHOW  ALL  command,  the  debugger  displays  all  the 
current  breakpoints  and  tracepoints  as  well  as  all  the  current 
settings  of  mode,  type,  output,  scope,  and  step  conditions. 

When  you  issue  the  CANCEL  ALL  command,  the  debugger  cancels  all 
breakpoints  and  tracepoints  and  returns  mode,  type,  output,  scope,  and 
stop  conditions  to  their  default  values. 
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CHAPTER  4 
EXAMINING  AND  DEPOSITING  DATA 


At  any  time  during  a  debugging  session,  you  can  use  the  EXAMINE 
command  to  look  at  the  values  of  •Jipecified  locations  to  see  if  they 
are  correct.  If  you  want  to  change  the  contents  of  locations,  you  can 
do  so  with  the  DEPOSIT  command.  This  chapter  tells  you  how  to  use 
these  two  commands  and  how  they  are  influenced  by  mode  and  type. 


4.1   MODE 

Mode  refers  to  the  form  in  which  the  debugger  interprets  and  displays 
information.   The  two  modes  are  radix  and  symbol. 

Radix  mode  determines  whether  integers  in  address  expressions  and 
value  expressions  are  interpreted  and  displayed  as  decimal,  octal, 
hexadecimal,  or  binary  ntimbers.   The  default  radix  mode  is  decimal. 

Symbol  mode  determines  whether  symbols  are  displayed  symbolically  or 
by  their  numeric  equivalents.   The  default  is  symbolic. 

You  can  use  the  SET  MODE  command  to  establish  either  kind  of  mode. 
The  following  example  sets  the  radix  mode  to  octal  and  the  symbol  mode 
to  nonsymbolic: 

DBG>SET  MODE  OCTAL,  NOSYMBOL 

A  radix  mode  specified  by  a  command  qualifier  overrides  the  effect  of 
the  SET  MODE  command.   See  Section  4.1.1. 

To  have  the  current  modes  displayed,  issue  the  following  command: 
DBOSHOW  MODE 


To  cancel  modes   established 
following  command: 


by   the   SET  MODE   command,   issue   the 


DBGKANCEL 


This  command  returns  the  mode  settings  to  their  defaults. 


4.i.l   Radix  Mode  Conaand  Qualifierii 

Tlie  radix  mode  command  qualifiers  are  /DECIMAL,  /OCTAL,  /HEXADECIMAL, 
Rf^  /BINARY.  They  can  be  used  with  these  commands:  DEPOSIT,  EXAMINE, 
EVALUATE,  and  EVALUATE/ ADDRESS.  With  the  EXAMINE  command,  you  can 
specify  mode  command  qualifiers  of  either  type  (radix  or  symbol). 
These  qualifiers  override  the  effect  of  the  SET  MODE  command. 
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For  example,  if  you  have  set  the  radix  node  to  octal  but  want  to 
display  the  value  of  a  particular  address  in  hexadecinal  node,  specify 
the  conmand  qualifier  as  follows: 

DBG> EXAMINE/HEX  VARl 


DBG> EXAMINE/HEX  3030 


DBG> EXAMINE/HEX   ILINE  20 

Note  that  In  this  exanple,  the  debugger  interprets  3030  as  a 
hexadecinal  nuaber,  but  interprets  20  as  a  decimal  number  because  it 
is  a  line  number.  Line  numbers  are  always  interpreted  in  the  decimal 
radix,  regardless  of  mode  settings. 

The  following  example  further  illustrates  the  caution  you  must  observe 
when  specifying  radix  mode  command  qualifiers.  Suppose  that  you 
discover  that  the  virtual  memory  address  of  VAR2(99}  is  3030  in  the 
current  radix: 

DBG>SHOW  MODE 

modes:  symbol , dec ima 1 

DBG> EVALUATE/ADDRESS  VAR2 (99) 
3030 

If  you  then  want  to  examine  address  3030  in  hexadecimal  mode  and  you 
issue  the  following  command,  you  will  get,  instead  of  the  information 
you  want,  the  hexadecimal  value  at  the  hexadecimal  address  3030: 

DBG> EXAMINE/HEX  3030 
3030:      127AE 


To  get  what  you  originally  wanted,  the  hexadecimal  value  at 
you  can  issue  the  following  command: 

DBG> EXAMINE/HEX  \ 


VAR2(99) 


With  the  DEPOSIT  command,  the  radix  mode  qualifier  determines  the 
interpretation  of  integers  in  nhe  address  expression  and  value 
expression.  The  followirig  example  deposits  the  octal  number  40  into 
the  current  location: 


DBG> DEPOSIT/OCTAL 


40 


4.1.2  Symbol  Node 

If  the  symbol  mode  is  set  to  symbolic,  the  debugger  displays  addresses 
in  their  symbolic  representation  (if  any  exists).  If  the  symbol  mode 
is  set  to  nonsymbolic,  the  debugger  displays  addresses  in  the  current 
radix  mode.  Symbol  mode  affects  only  the  debugger's  display; 
therefore,  you  can  enter  either  symbolic  or  nonsymbolic  values, 
regardless  of  the  mode  setting. 
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In  nonsymbolic  mode,  the  debugger  displays  the  location  denoted  by  an 
address  expression  as  a  virtual  address,  whether  or  not  that  address 
is  represented  by  a  symbol. 

For  example,  if  the  current  default  modes  are  symbolic  and  decimal, 
address  expression  A  is  displayed  in  the  following  symbolic  form: 

DBOEXAMINE  A 
ROUT\A:   0123 

In  nonsymbolic  form,  the  same  address  expression  is  displayed  as 
virtual  address  414: 

DBOEXAMINE/NCSYMBOL  A 
414:   0123 

The  following  example  demonstrates  that  you  can  enter  either  symbolic 
or  nonsymbolic  values,  regardless  of  mode  settings.  Only  the  debugger 
display  is  affected  by  mode  values. 

DBOSHOW  MODE 

modes:  nosymbol ,  decimal 

DBOEXAMINE  414 
414:   0123 


DBOEXAMINE  A 
414:   0123 


The  symbol  mode  also  affects  the  way  the  processor   status   word  (PS) 

and   the  floating-point  status  word  (FS)  are  displayed.   When  the  mode 

is  symbolic,  the   debugger   gives   you   a   formatted   display   of  the 
contents  of  the  PS  and  the  FS.   For  example: 


DBOEXAMINE 

^PS 

%PS: 

CURMOD 

PREMOD 

REGS 

XXX 

IPL 

T 

N 

Z 

V 

c 

00 

00 

0 

000 

000 

0 

0 

0 

0 

0 

If  the  mode  is  nonsymbolic,  the  display  of   the 
formatted.   For  example: 

DBOEXAMINE/NCSYMBOL  %PS 
%PS:    0 


PS   and   FS   is   not 


4.2   TYPE 

PDP-11  FORTRAN-77  DEBUG  supports  all  the  FORTRAN-77  data  types.  The 
FORTRAN-77  data  types  and  their  PDP-11  FORTRAN-77  DEBUG  equivalents 
are  listed  in  Table  4-1. 
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Table  4-i :  PORTRAN-77  and  DEBUG  Oita  Types 


FORTRAN- 7 7 
Data  Type 


Equivalent 
DEBUG  Data  Type 


BYTE 

LOGICAL 

LOGICAL*! 

L0GICAL*2 

L0GICAL*4 

INTEGER 

INTEGER*2 

INTEGER*4 

REAL 

REAL»4 

REALMS 

DOUBLE  PRECISION 

COMPLEX 

COMPLEXES 

CHARACTER* len^ 


BYTE 
Mono 

BYTE 

WORD 
LONG 


Radlx-50 


MACRO-11  Instruction 


WORD 

LONG 

FLOAT 

FLOAT 

D^PLOAT 

D^FLOAT 

Use  two  FLOAT  numbers 

Use  two  FLOAT  numbers 

ASCin  :n]^ 

RAD50 


INSTRUCTION 


1.  len  and  n  both  represent  the  same  thing: 
the  number  of  characters  specified.  This 
number  can  be  any  integer  from  1  through  255. 

Debugger  types  are  associated  with  addresses  and  values  in  a  number  of 
ways.  At  task-build  time,  program  symbols  are  associated  with  their 
compiler-generated  types  (see  Section  2.1.1).  At  the  beginning  of  a 
^  "    '  ' '"         *^^    ^  "        associates   any   untyped   program 

type,  word  integer.  During  a 
associates  a  type  with  an  address 
(steps   are   listed   in   order   of 


debugging    .session,   the   debugger 
locations  with  the  debugger  default 
debugging   session,   the   debugger 
expression  in   the   following   way 
decreasing  precedence) : 


X^ 


address 
with  the 


3* 


If  a  type  command  qualifier  is  specified  with  an 
expression,  then  the  qualifier  type  is  associated 
address  expression  while  the  command  is  in  effect. 

If  the  program  location  denoted  by  the  address  expression  has 
•  compiler-generated  tyo«,  then  the  compiler-generated  type 
is  associated  with  the  adJr^jsp  expression. 

If  a  type  is  not  assccloted  with   an  address   expression   in 

eltner    of    the   above   ways,   the  address   expresslcr   is 

associated  with  the  type  specified  in  the  most  recer«t  SET 
TYPE  command. 
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As  the  preceding  list  indicates,  you  can  change  the  default  type  with 
the  SET  TYPE  command,  and  you  can  override  the  effect  of  the  SET  TYPE 
command  by  specifying  a  qualifier  with  another  command.  The  types 
that  you  can  specify  are  listed  in  Table  4-1  and  in  dapter  5  under 
SET  TYPE. 

To  return  the  type  to  the  default,  use  the  CANCEL  TYPE  command.  To 
find  out  what  type  is  currently  in  effect,  use  the  SHOW  TYPE  command. 


4.3   THE  EXAMINE  COMMAND 

The  EXAMINE  command  lets  you  look  at  the  contents  of  specified 
locations.   It  has  the  following  format: 

EXAMINE  [/qualifier...]   [exa-spec] 

The  qualifiers  you  may  use  with  the  EXAMINE  command  are  type  and  mode 
qualifiers.  They  are  listed  in  Chapter  5  under  the  EXAMINE  command. 
(See  Section  4.2  for  a  discussion  of  type  and  Section  4.1  for  a 
discussion  of  mode.)  The  parameter  exa-spec  may  be  either  a  single 
address  expression  or  ^  range  of  address  expressions. 

To  examine  a  range  of  addresses,  specify  the  first  and  last  addresses 
of  the  range  and  separate  them  with  a  colon,  as  follows: 

EXAMINE   lARR(l) :IARR(10) 

The  EXAMINE  command  causes  the  contents  of  the  specified  location(s) 
to  be  displayed  in  the  type  associated  with  the  first  element  of  the 
range,  unless  you  specify  a  type  qualifier  with  the  command.  If  the 
first  element  is  untyped,  the  debugger  uses  the  type  specified  in  the 
most  recent  SET  TYPE  command.  In  the  following  example,  a  range  is 
examined  first  in  word  integers  and  then  in  bytes. 


DBG>E  1:11-3 
CALCM:  0 
CALCXJ:    21 

DBOE/BYTK  I  !l4^3 
CALCM:    0 
CALC\H-1:  0 
CALCXJ:   21 
CALC\J+1:  0 

It  is  possible  to  specify  a  type  qualifier,  a  radix  mode  qualifier, 
and  a  symbol  mode  qualifier  with  a  single  EXAMINE  command,  as  the 
following  example  indicates: 

DBOE/BIN/BYTE/SYMB  IHl 
CALCNCHI:    10001110 

If  your  program  is  overlaid,  you  may  examine  only  currently  resident 
program  locations. 

The  following  example  demonstrates  that  array  subscripts  are  always 
entered  and  displayed  as  decimal  integers,  regardless  of  the  radix 
mode: 

DBOE/PY/OCT  BUF(3) 
.MAIN.\BUF(8) :    004 

See  Section  4.1.1  for  other  examples  of  the  use  of  the  EXAMINE 
command • 
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4.4   TBE  DEPOSIT  COMMAND 

The  DEPOSIT  command  changes  the  value  of 
following  format: 


location. 


It  has   the 


DEPOSIT  [/qualifier...]  addr-expr-value-expression  ( ,value>expression . . .] 

When  the  debugger  executes  the  DEPOSIT  command,  it  converts  the  value 
of  the  value  expression  to  the  type  associated  with  the  address 
expression  and  deposits  the  value  at  the  location  designated  by  the 
address  expression. 


You  can  use  a  single  DEPOSIT  comma 
expression;  you  list  the  expr 
side  of  the  equal  sign  and  separat 
deposits  the  value  of  the  firs 
denoted  by  the  address  expressi 
subsequent  value  expressions  in 
lo  ^ation  denoted  by  the  address  ex 
musc  be  depositing  into  an  arra 
register.  You  cannot  use  a  single 
of  other  kinds  of  variables. 


nd  to  deposit  more   than   o 
essions  to  be  deposited  on 
e  them  with   commas.    The 
t  value  expression  into  the 
on,   then  deposits   the   v 
to   the   logical   successor 
pression.   Note,  however, 
y,  an  untyped  storage  locat 
command  to  make  successive 


ne   value 

the  right 

debugger 

location 

alues  of 

s   of  the 

that   you 

ion,  or  a 

deposits 


The  following  example  shows  the  results  of  depositing   three   integers 
into  logically  successive  locations  \n   array  A: 

DBOSHOW    MODE 

modes : symbol ic ,    decimal 

DBODEPOSIT    A(4)     «    42,    6000,    819 

DBOEXAMINE     . 
CAR\A(6):  8J9.0000 

DBG>PXAMINE    *  . 

CAR\A(5):  6000.0000 

DBG>£XAMINE    " 
CAR\A(4):  42.0000 


Note  that  the  debugger  displays  the  values  of  the  deposited  variables 
in  the  type  associated  with  their  locations  (in  this  case,  real), 
rather  than  in  the  default  type. 

You  may  use  a  type  command  qualifier  with  the  DEPOSIT  command  to 
associate  a  type  with  the  location  denoted  by  the  address  expression 
while  the  command  is  in  effect.  The  following  example  demonstrates 
the  use  of  a  type  command  qualifier  with  the  DEPOSIT  command: 


DBOSHOW  TYPE 
type:   long  integer 

DBOEVAL/ADDR  . 
944 

DBG>DEPOSIT/BYTE  .  »  1 

DBG>F  . 

944:   1280461057 

DBOE/BYTE  . 
944:   1 
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You  may  use  a  radix  mode  qualifier  with  the  DEPOSIT  command  to 
influence  the  interpretation  of  integers  in  both  the  address 
expression  and  the  value  expression.  See  Section  4.1.1  for  more 
information  about  radix  mode  command  qualifiers. 

To  deposit  a  complex  number,  specify  both  the  real  and  the  imaginary 
part  as  REAL*4  (FLOAT)  numbers.  Do  not  enclose  the  complex  number  in 
parentheses.   For  example: 

DBODKP/FLOAT  .  «  2394  .E3  ,-1  .6120  1 

Note  that  when  you  use  the  E  format,  you  must  include  the  decimal 
point  so  the  debugger  can  discriminate  between  the  decimal  and 
hexadecimal  radixes. 

If  your  program  is  overlaid,   you  may  deposit   only   into   currently 

resident   prograir   locations.    If  you  deposit  into  a  resident  segment 

other  than  the  root,  the  deposited  data  will  be  destroyed  if  the 
segment  is  refreshed. 


4.4.1   Depositing  ASCII  Strings 

If  the  value  expression  to  be  deposited  is  an  ASCII  string,  it  must  be 
delimited  by  quotation  marks  (")  or  by  apostrophes  (•).  If  the  length 
of  the  string  to  be  deposited  is  greater  than  the  length  associated 
with  the  address  expression,  the  string  is  truncated  on  the  right.  If 
the  length  of  the  string  ir  less  than  the  longth  associated  with  the 
address  expression,  the  debugger  inserts  ASCII  blanks  to  the  right  of 
the  last  character  in  the  string. 

If  you  want  to  deposit  into  a  location  associated  with  a  type  other 
than  ASCII,  you  can  use  the  /ASCII (:n]  command  qualifier  to  override 
the  associated  t/pe  while  the  command  is  in  effect.  The  following  is 
the  format  of  the  /ASCII(:n]  qualifier  with  the  DEPOSIT  command: 

DEPOSIT/ASCIU :nj  addr-expr«"ASCI I  string  of  length  n* 

The  value  n  used  in  the  command  qualifier  should  correspond  to  the 
number  of  ASCII  characters  to  be  deposited,  that  is,  to  the  length  of 
the  ASCII  string. 

The  following  example  shows  how  to  deposit  an  IS-character  ASCII 
string  at  line  3  of  module  ID. 

DBODEP/ASCII  :  18  IDMLINE  3  «  'The  patient's  rx^me' 

If  you  want  to  deposit  into  a  location  that  does  not  have  an 
associated  type,  use  the  command  SET  TYPE  ASCII (:n]  to  associate  the 
type  ASCII  with  the  location.  The  value  n  is  interpreted  in  the 
decimal  radix.  If  n  is  omitted,  the  debugger  assumes  a  default  value 
of  two  bytes.  The  effects  of  the  SET  TYPE  ASCII (;n]  command  can  be 
overridden  by  a  type  specified  as  a  command  qualifier. 


4.4.2   Depositing  Radix*50  Strings 

You  use  the  /RAD50  qualifier  with  the  DEPOSIT  command  to  dep>osit  a 
value  expression  that  is  a  Radix-SO  string.  The  string  must  be 
delimited  by  quotation  marks  (*)  or  by  apostrophes  (*)•  If  the  length 
of  the  quoted  string  is  not  a  multiple  of  three  bytes,  it  is  padded  on 
the  right  with  blanks. 
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EXAMINING  AND  DEPOSITING  DATA 
The  DEPOSIT  Comiiand 


The  /RAD50  qualifier  associates  the  type  RAD50  (length  two  bytes)  with 
the  value  expression. 

In  the  following  example,  twp  successive  locations  are  examined  in 
Radix-SO,  and  then  the  value  of  the  first  location  is  changed  with  the 
DEPOSIT  command. 


DBOEX/RAU  BUF(i)  :BUF(2) 
.MAINABUF(1)<0,16>:   HAL 
.MAIN.\BUF(2)<0,16>:   E 
DBODEP/RAD  BUF(l)  «  "GEG 
DBG>EX/RAD  BUF  (1) 
.MAIN.\BUF(1)<0,16>:   GEG 
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CHAPTER  S 


DEBUGGER  COMNAMDS 


This  chapter  contains  a  suMiary  of   debugger   comnands   in   alphabetic 
order. 


5-1 


DEBUGGER  COMMANDS 
9file-8pec 

@fiie-spec 

Description 

Switches  from  the  current  command  stream  to  the  specified  file, 
and  executes  the  commands  within  the  file.  Any  PDP-11  FORTRAN-77 
DEBUG  command  may  appear  in  the  file,  including  other  ^file 
commands.  Commands  are  executed  from  the  file  until  either  an 
EXIT  command  or  an  end-of-file  is  reached. 

To  have  the  commands  from  the  command  file  displayed  in  the 
debugger  output,  use  the  VERIFY  parameter  with  the  SET  OUTPUT 
command. 

The  debugger  assumes  a  file  type  of  CMD  if  none  is  specified. 
Foraat 

#file-spec 


Coaaand  Paraaeter^s 
'ile-spec 

The  name  of  the  file  to  be  executed. 


Coiuiand  Qualifiers 


None 


Exanple 


DBG?    SET  OUTPUT  VERIFY 
DBG>  ^MAIN 

%F77DBG-I-VERIFYICF,  entering  indirect  command  file  "MAIN" 

SET  BR  SUBlXSUBi 

GO 

routine  start  at  MAIN 
routine  break  at  SU31 

%F77DBG-I-VERIFYICF,  exiting  indirect  command  file  "MAIN" 
DBG> 


5-2 


DEBUGGER  COMMANDS 
CANCEL  ALL 


CANCEL  ALL 


Description 


Cancels  all  breakpoints  and  tracepoints.  Restores  to  their 
default  values  user-set  mode,  type,  scope,  output  conf iguat ion . 
and  step  conditions. 


foraat 


CANCEL  ALL 


CoMiand  Parameter: 


None 


Consiand  Qaalifiers 


None 


BxMipl« 


DBG>  CANCEL  ALL 
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DEBUGGER   COMMANDS 
CiOICEL   BREAK 


CANCEL  BREAK 


Description 


Cancels  th«  specified  breakpoint (s) .  You  must  specify  either  an 
address  expression  or  /ALL  or  /CALLS.  If  you  specify  an  address 
expression,  you  have  the  option  of  specifying  /RETURN. 

Attempting  to  cancel  a  nonexistent  breakpoint  results  in  an 
error. 


Foraat 


CANCEL   BREAK    [/qualifier]     [ddd'-exprj 


CoMiand   P'lraaeters 


addr-«xpr 


An  address  expression  that  denotes  the  location  of  th<  breakpoint 
to  be  canceled. 


CoMiand  Qualifiers 


/ALL 


Cancels  all  breakpoints 


/RBTURM 


Cancels  a  breakpoint  at  the  start  of  the  return  sequence  of  a 
routine.  You  must  specify  the  routine  with  an  address 
expression* 


/CALLS 


Cancels  breakpoints  at  all  JSR  and  RTS  instructions. 


Examples 


DBG>  CANCEL  BREAK  SUBINSUBI 
DBG>  CANCEL  BREAK  PROGXMLINE  3 
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DBBUGGER  COMMANDS 
CANCEL  NODE 

CANCEL  MODE 


Description 


Cancels  thtr  radix  node  and  the  sy»bol  mode  established  by  the  SET 
NODE  co«Band.   Reestablishes  the  default  node  values. 


Forsat 


CANCEL  MODE 


and  Parac«t«rs 


None 


CoMiand  Qualifiars 


None 


Bxaapls 


DBG>   ANCI.L  MODE 

DBG>  SHOW  « <)r  f 

»od^:  syaboiic,  decmal 
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DEBUGGER   COMMAIIDS 
CANCEL    OUTPUT 


CANCEL  OUTPUT 


Description 


Cancels  the  output  configuration  established  by 
connand.   Reestablishes  default  output  values. 


the   SET   OUTPUT 


Format 


CANCEL  OUTPUT 


CoMiand  Parameters 


NOfM 


Command  Qualifiers 


None 


EsampXs 


DBG>  CkHCtl   OUTPUT 
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DEBUGGER  COfWANDS 
CANCEL  SCOPE 

CANCEL  SCOPE 


Description 


Cancels  the  scope  established  by  the  SET  SCOPE  command. 

As  a  result  of  the  CANCEL  SCOPE  command,  symbols  without  scope 
prefixes  are  interpreted  as  if  they  occurred  in  the  current 
program  unit,  that  is,  the  program  unit  containing  the  program 
counter  (PC) • 

The  CANCEL  SCOPE  command  is  equivalent  in  effect  to  the  command 
SET  SCOPE  0. 


Pomst 


CANCEL  SCOPE 


fid  Par 


ters 


None 


Coaiisnd  Qualifiers 


None 


/ 


/ 


Exaaple 


/ 


DBOCANCEL   SCOPE 
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DEBUGGER  COMMANDS 
CANCEL  STEP 

CANCEL  STEP 


Description 


Cancels  the  effects  of  the  SET  STEP  command  and  restores  step 
conditions  to  their  default  (stepping  by  line  and  over  called 
routines) • 


format 


CANCEL  STEP 


Cooaand  Paraneters 


None 


CoMNand  Qualifiers 


None 


Exaapia 


DBG>  CANCEL  STEP 
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CANCEL  TRACE 

CANCEL  TRACE 


Description 


Cancels  the  specified  tracepoint (s) .  You  must  specify  either  an 
address  expression  or  /ALL  or  /CALLS.  If  you  specify  an  address 
expression,  you  have  the  option  of  specifying  /RETURN. 


Attempting  to  cancel   a 
error  . 


nonexistent   tracepoint   results   in   an 


Foraat 


CANCEL   TRACE    [/qualifier]     [addr-expr] 


Coioiand   Paraneters 


addr-expr 


An  address  expression  that  denotes  the  location  of  the  tracepoint 
to  be  canceled,  t^        ^ 


Conmand  Qualifiers 


/ALL 


Cancels  all  tracepoints. 


/RETURN 


Cancels  a  tracepoint  at  the  start  of  the   return   sequence   of   a 
routine.     You   must    sp.^cify   the   routine   with   an   address 


expression. 


/CALLS 


Cancels  breakpoints  at  all  JSR  and  RTS  instructions. 


Examples 


DBG>  CANCEL    TRACE/RETURN    S'JB1\SUB1 
DBG> CANCEL    TRACE    SUB1\%LINE    2 
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OeBUGGCR  COMHANDS 
CAMCCL  TYPE 


CANCEL  TYPE 


Description 


Cancels  th«  •ffect  of  the  SET  TYPE  cooMiand  and  returns  the  type 
to  the  d^tfault.  This  comand  has  no  effect  on  typ«s  specified 
irith  conr««nd  qualifiers. 


Format 


CAMCEL  TYPE 


CoflAand  Par 


ters 


None 


nd  0«^iifisr* 


ExaBple 


DK>  CAMCtt  TYPE 
DtC>  SHOW  TYPE 
type:  word  inte9er 
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DBBUGGER   COMMANDS 

DEPINB 


DEFINE 


Description 


Defines  a  symbol  and  assigns 
reealnder   of  the  debugging 
for  the  s/abol  is  executed. 


it   a   specified   address   for   the 
ssion^  or  until  an  UNDEFINE  command 


Inforttft.  Lion  about  overlay  segments  is  not  retained  in  a  defined 
symbol  Thus,  If  you  use  a  defined  symbol  rather  than  a  pathname 
to  examine  or  deposit  a  value  that  lies  in  an  overlay  segment, 
the  debugger  does  not  check  to  see  if  the  location  is  currently 
resident. 

In  symbol  translation,  the  debugger  first  searches  symbols  you 
define  durincj  the  debugging  session.  Cons<.quently ,  if  you  >fine 
a  symbol  that  already  exists  in  your  program,  the  debugger 
translates  the  symbol  accok'ding  to  the  definition  you  give  it, 
unless  you  specify  a  pathname. 

You  can  use  the  rVALUATE  command  to  determine  what  a  symbol 
represents. 


Fornat 


DCFINe   symbol   «   addr-expr 


ffid  Parameters 


symbol 


Specifies  the  name  of  a  symbol   to   be   defined.    The   following 
rules  must  be  followed  when  defining  a  symbol  name: 

•   A  symbol  may  be  composed  of  alphanumeric  characters   (A-Z   and 
0-9)  and  dollar  signs  ($) . 


•  Lowercase   and   uppercase   alphabetic    characters 
differentiated. 

•  The  first  character  may  not  be  a  digit  (0-9). 

•  A  symbol  must  be  no  more  than  six  characters  long. 


are 


not 


addr-expr 


Either  a  virtual  address  or  a  symbolic  address.   Integers  in   the 
address  expression  are  interpreted  in  the  current  radix. 


and  Qualifiers 


None 


Ixampla 


DBG>  DEFINE  buffer  •  iSEGXENT  SUB2\SUB2\BUFF1 
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DIBUGGBR   CONMAIIDS 
DEPOSIT 


DEPOSIT 


Description 


Deposits  the  value  expression  directly  following  the  equal  sign 
(s)  into  the  location  denoted  by  the  address  expression,  and 
deposits  any  additional  value  expressions  specified  into 
locations  that  are  logical  successors  to  the  location  denoted  by 
the  specified  address  expression.  If  two  or  more  value 
expressions  are  specified  in  the  command,  commas  are  used  to 
separate  them.  The  DEPOSIT  command  sets  the  current  location 
symbol  (.)  to  the  program  location  denoted  by  the  address 
expression. 

Type  command  qualifiers  may  be  used  to  associate  a  type  with  the 
location  denoted  by  the  address  expression.  The  debugger  treats 
LOGICAL  types  as  INTEGER  types.  Radix  mo<^e  qualifiers  may  be 
used  to  influence  the  interpretation  of  integers  in  the  address 
expression  and  value  expressions;  otherwise,  the  current  default 
radix  is  used. 

You  may  only  deposit  into  currently  resident  program  locations. 
If  you  deposit  into  a  segment  other  than  the  root,  the  deposited 
data  will  be  destroyed  if  the  segment  is  refreshed. 


Poraat 


DEPOSIT  [/qualifier...]  addr-expr  *  value-expr  [ ,value-expr . . .J 


CoHiand  Peraaeters 


addr-expr 


The  location  into  which  the  value  expression  immediately 
following  the  equal  sign  (»)  is  deposited.  The  debugger  always 
interprets  subscripts  in  address  expressions  as  decimal  numbers. 


value-expr 


The  value  to  be  deposited.  If  more  than  one  value  expression  is 
specified,  the  first  value  expression  is  deposited  at  the 
location  denoted  by  the  address  expression,  the  second  value 
expression  at  the  location  denoted  by  the  logical  successor,  and 
so  on,  for  each  value  expression  specified.  Separate  multiple 
value  expressions  with  commas. 


Radix  mode   qualifiers  affect   the   interpretation  of 
expression. 


a  value 


Upon  execution  of  the  DEPOSIT  command,  the  value  of  the  value 
expression  Is  converted  to  the  type  associated  with  the  address 
expression  and  placed  at  the  location  denoted  by  the  address 
expression. 

If  the  value  expression  is  an  ASCII  or  RADbO  string,  it  must  be 
delimited  by  quotation  marks  (")  or  by  apostrophes  (')•  If  the 
length  of  the  string  is  greater  than  the  length  associated  with 
the  address  expression,  the  string  is  truncated  on  the  right. 
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DEBUGGER  COMMANDS 

DEPOSIT 


CoHiand  Qualifiers 
/BYTE 


Associates  the  type  byte   integer   (length  one   byti)   with   the 
location  denoted  by  the  address  expression. 

Thib  type  is  equivalent  to  FORTRAN-77  BYTE  and  LOGICAL*!. 


/WORD 


Associates  the  type  word  integer   (length   two   bytes)   with   the 
location  denoted  by  the  address  expression. 

This  type  is  equivalent  to  FORTRAN-77  INTEGER*2  and  L0GICAL*2. 


/LONG 


Associates  the  type  long  integer  (length   four   bytes)   with   the 
location  denoted  by  the  address  expression. 


This  type  is  equivalent  to  FORTRAN-77  INTEGER*4  and  L0GICAL*4. 


/FLOAT 


Associates  -.he  type  single-precision  floating  point  (length 
bytes)  with  the  location  denoted  by  the  address  expression. 

This  type  is  equivalent  to  FORTRAN-77  REAL*4. 


four 


/D  FLOAT 


Associates  the  type  double-precision  floating  point  (length  eight 
bytes)  with  the  location  denoted  by  the  address  expression. 


This   type   is   equivalent   to   FORTRAN-77   REAL*8    and 
PRECISION. 


DOUBLE 


/ASCII (:n) 


Associates  the  type  ASCII  of  length  n  bytes  with  the  location 
denoted  by  the  address  expression.  The  value  n  is  interpreted  in 
the  current  radix  mode  unless  a  radix  mode  command  qualifier  is 
specified.  If  n  is  less  than  the  length  of  the  quoted  string, 
the  string  is  truncated.  If  n  is  greater  than  the  length  of  the 
quoted  string,  the  string  is  padded  on  the  right  with  blanks.  If 
n  is  omitted,  the  debugger  uses  the  length  of  the  quoted  string. 


This  type  is  equivalent  to  FORTRAN-77  CHARACTER* len. 


/RAD50 


Associates  the  type  RAD50  (length  two  bytes)  with  the  value 
expression.  The  value  expression  must  be  a  quoted  string  and 
must  contain  only  legal  Radix-50  characters.  If  the  length  of 
the  quoted  string  is  not  a  multiple  of  three  bytes,  the  string  is 
padded  on  the  right  with  blanks. 

Thi«  type  is  equivalent  to  Radix-50. 


/DECIMAL 


Interprets  the  integers   In   the  address   expression  and   value 
expressions  in  the  decimal  radix. 
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DEBUGGER  CONIUIIDS 
DEPOSIT 


/BIMARY 


Interprets  the  integers   in   the 
expressions  in  the  binary  radix. 


/OCTAL 


Interprets  the  integers   in   the 
expressions  in  the  octal  radix. 


/HEXADECIMAL 


address  expression  and  value 


address  expression  and  value 


Interprets  the  integers   in   the  address   expression  and  value 
expressions  in  the  hexadecimal  radix. 


Bxaaples 


DBG> DEPOSIT/BYTE. 'BINARY    CH I -H  =0010000 1 
DBODEPOSIT/FLOAT    SUM^4205.977 
DBODEPOSIT    A(6)»43,901,20 
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DEBUGGER  COMMANDS 
DISABLE  BREAK 

DISABLE  BREAK 


Description 


disabled 
and;   the 


Prevents  the  occurrence  of  all  breakpoints.  A 
breakpoint  can  be  reenabled  by  seans  of  the  ENABLE  co 
event  does  not  have  to  be  respecified. 

rllirLr,         1       ^^*  effects  of  the  CANCEL  ALL  coMand  cannot  be 
revers^ed  unless  you  respecify  the  canceled  breakpoints. 


format 


DISABLE  BREAK 


and  Parameters 


None 


CoMBand  Qualifiers 


None 


Exaaple 


DBG>  DISABLf:  BREAK 
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DBBUGGBR  COMMANDS 
DISABLE  TRACE 


DISABLE  TRACE 


Description 


Prevents  the  occurrence  of  all  tracepoints.  A  disabled 
nracepoint  can  be  reenabled  by  the  ENABLE  TRACE  command;  the 
tracepoint  does  not  have  to  be  respecified. 

Note  that  the  DISABLE  TRACE  command  and  the  CANCEL  ALL  command 
differ  in  that  the  effects  of  the  CANCEL  aLL  command  cannot  be 
reversed  unless  you  respecify  the  canceled  tracepoints. 


Poraat 


DISABLE  TRACE 


CoAnand  Paraiieters 


None 


CoMiand  Qualifiers 


None 


Exanple 


DBG>  DISABLE  TRACE 
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DEBUGGER  COMMANDS 
ENABLE  BREAIC 


ENABLE  BREAK 


Description 


Reverses  the  effect  of  the  DISABLE  BREAK  co 
the  breakpoints  to  occjr. 


end,   thus  allowing 


Foraet 


ENABLE    BREAK 


liid   Persseters 


None 


CooBaml  g«Milifiers 


None 


Kxesple 


DBG>    t.sABLE    BREAK 
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DEBUGGER  COHMAMDS 
ENABLE  TRACE 


ENABLE  TRACE 


Description 


Reverses  the  effect  of  the  DISABLE  TRACE  comioand , 
the  tracepoints  to  occur. 


thus  dllowin<j 


Poraat 


ENABLE  TRACE 


CoHiand   Paraaetftfs 


None 


CoMiand  Qualifiers 


None 


Exaapla 


DBOENABLE  TRACE 
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DEBUGGER   COMMAIIDS 
EVALUATE 

EVALUATE 


Description 


E/aluates  either  an  address  expression  or  a  value  expression, 

the    /ADDRESS  qualifier    is    specified,   the   expression 

interpreted   as  an   address   expression;     otherwise,    it 

interpreted  as  a  value  expression. 


If 
is 
is 


If  a  radix  mode  conwand  qualifier  is  specified,  the  debugger 
interprets  integers  in  the  expression  in  that  radix  and  displays 
the  value  of  the  expression  as  a  literal  in  that  radix. 

Using  the  EVALUATE  coronand,  you  can  perfom  arithmetic 
calculations  that  may  or  may  not  be  related  to  your  program.  In 
eftect,  you  can  use  the  debugger  as  a  calculator. 

You  cannot  evaluate  an  expression  that  contains  variables  not 
cuirently  resident. 


format 

EVALUATE  I/qualifier...)  expression 
Command  Paramstsrs 
•xprsssion 

Any  legal  value  expression  or  address  expression. 
Coanand  Qualifiers 
/ADDRESS 

Interprets  the  expression  as  an   address  expression  whose  value  is 
a  virtual  memory  address. 


/DECIMAL 


Interprets  the  integers  in  expression  m  the 
displays  the  value  of  expression  in  the  deci 


decimal   radix 
1  radix. 


and 


/BINARY 


Interprets  the  integers  in  expression  m   the   binary 
displays  the  value  of  expression  in  the  binary  radix. 


radix   and 


/OCTAL 


Interprets  the  integers  in  expression   in   the   octal 
displays  the  value  of  expression  in  the  octal  radix. 


radix   and 


/HEXADECIMAL 


Interprets  the  integers  in  expression  in   the   hexadecimal   radix 
mnd   displays  the  value  of  expression  in  the  hexadecimal  radix. 


Examples 


DBG>  EVALUATE  'entering  ruutine 
'entering  routine  GAMMA* 

DBG>  EVALUATE  ADDRESS  :>UB1\SUBI 
000  326 


;amma  ' 
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DBBUGGER  COMMANDS 
BXAMIME 


EXAMINE 


Description 


Displays  the  value  of  the  entity  at  the  location  denoted   by 
address  expression  in  the  type  associated  i#ith  that  location 


the 


You  can  examine  a  range  of  entities  v#ith  a  single  EXAMINE  coMiand 
by  entering  the  address  expression  that  denotes  the  first 
location  in  the  range,  a  colon  (:),  and  the  address  expression 
that  denotes  the  last  entity  in  the  range. 

If  you  specify  a  type  conmand  qualifier  with  the  ::XAMINE  coeaand, 
the  debugger  displays  the  entities  in  that  type;  otherwise,  the 
debugger  uses  either  the  default  type  or  the  type  associated  with 
the  location.  The  debugger  treats  LOGICAL  types  as  INTEGER 
type  . 

If  you  specify  a  radix  eode  qualifier  with  the  EXAI1INE  coeeand, 
the  debugger  interprets  integers  in  the  address  expression  in 
that  radix  and  displays  the  examined  entity  or  entities  in  the 
specified  radix. 

If  the  sode  is  SYMBOL,  the  debugger  displays  address  expressions 
and  instruction  address  operands  symbolically  (if  possible).  If 
the  mode  is  NOSYMBOL,  the  address  expressions  af  displayed  as 
integers. 

If  the  mode  Is  SYMBOL,  and  you  examine  the  processor  status  word 
(PS)  or  the  floating-point  status  word  (FS) ,  they  will  be 
displayed  in  a  formatted  arrangement;  otherwise,  the  debugger 
displays  their  contents  as  a  numeric  literal  in  the  current 
radix. 

If  you  use  the  EXAMINE  command  without  specifying  exa-spec,  the 
next  location  is  examined. 


You  may  examine  only  currently  resident  program  locations 


format 


EXAMINE    I/qualifier...]     (exa-spec) 


Command  Parameters 


exa-spec 


The  entity  to  be  examined.   It  can  take  either  of  two  forms 

1.  addr-expr 

2.  addr-expr    :      addr-expr 
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DEBUGGER   COflflAIIDS 

EXAMINE 


CoHiand  Qualifiers 


/BYTE 


Associates  the  type  byte   integer   (length   one   byte)   with 
location  denoted  by  the  address  expression. 

This  type  is  equivalent  to  FORTRAN-77  BYTE  and  L0GICAL*1. 


the 


/MORO 


)   with   the 


Associates  the  type  word  integer   (length   two   bytes 
location  denoted  by  the  address  expression. 

This  type  is  equivalent  to  FORTRAN-77  iNTEGER*2  and  L0GICAL»2. 


/LONG 


Associates  the  type  long  integer  (length   four   bytes 
location  denoted  by  the  address  expression. 


)   with   the 


This  type  is  equivalent  to  FORTRAN-77  INTEGER*4  and  L0GICAL*4. 
/FLOAT 


Associates  the  type  single-precision  floating  point  (length 
bytes)  with  the  location  denoted  by  the  address  expression. 

This  type  is  equivalent  to  FORTRAN-77  REAL*4 . 


four 


/D  FLOAT 


Associates  the  type  double-precision  floating  point  (length  eight 
bytes)  with  the  location  denoted  by  the  address  expression. 


This   type   is   equivalent   to   FORTRAN-77   REAL*8    and 
PRECISION. 


IX)UBLE 


/ASCII! :nl 


Associates  the  type  ASCII  of  length  n  bytes  with  the  location 
denoted  by  the  address  expression.  The  value  n  is  interpreted  in 
the  radix  specified  by  a  radix  mode  command  qualifier  or  in  the 
current  radix  mode.  if  n  is  omitted,  the  debugger  assumes  a 
default  value  of  two  bytes. 

This  type  is  equivalent  to  FORTRAN-77  CHARACTER* 1  en . 
/INSTRUrriON 


Displays   the 
instructions. 


examined   entity   or    entities 


as 


MACRO-ll 


/RADSO 


Associates  the  type  RADSO  (length  two  bytes) 
denoted  by  the  address  expression. 

This  type  is  equivalent  to  Radix-SO. 


with  the   location 


/SYMBOL 


Displays  addresses  synbol ical ly. 
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DEBUGGER  COMMANDS 
SXAMINE 


/NOSYMBOL 


Displays  addresses  as  virtual  memory 
radix  mode. 


addresses   in   the   current 


/DECIMAL 


Interprets  the  integers  in  the  address  expressions  in  the  decimal 
radix.  Displays  the  addresses  and  the  values  of  the  locations 
denoted  by   the  address  expressions  in  the  decimal  radix. 


/BIMARY 


Interprets  the  integers  in  the  address  expressions  in  the  binary 
radix.  Displays  the  addresses  and  the  values  of  the  locations 
denoted  by  the  address  expressions  in  the  binary  radix. 


/OCTAL 


Interprets  the  integers  in  the  address  expressions  in  the  octal 
radix.  Displays  the  addresses  and  the  values  of  the  locations 
denoted  by  the  address  expressions  in  the  octal  radix. 


# 


/HEXADECIMAL 


Interprets  the  integers  in  the  address  expressions  in  the 
hexadecimal  radix.  Displays  the  addresses  and  the  values  of  the 
locations  denoted  by  the  address  expressions  in  the  hexadecimal 
rad  ix . 


Exaaples 


DBG>    EXAMINE 

A(l) :A(5) 

A(l):     1.0000 

A(2)  :    2.0000 

A(3):    3.0000 

A(4) :    4.0000 

A(5) :    5.0000 

DBG>    EX    lit 

A(6) :    6.0000 

DBOFXAMINE/FLOAT    MEDIAN 
000104:  143.29 
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EXIT 


EXIT 


Description 


Ends  the  debugging  session,  or  ends  the  execution  of  commands  in 
a  command  procedure  or  DO  action. 

When  you  issue  the  EXIT  command  at  the  terminal,  you  cause 
orderly  termination  of  the  debugging  session.  You  cannot 
continue  to  debug  your  program  by  issuing  the  DCL  DEBUG  command. 
To  restart  the  debugger,  you  mi.»st  run  t' e  program  again. 

When  the  debugger  encounters  an  EXIT  command  in  a  DO  action  or  in 
a  command  file,  the  debugger  returns  to  the  command  stream  that 
invoked  the  DO  action  or  the  command  file.  For  example,  if  a 
command  file  ^as  invoked  from  within  a  DO  action,  control  returns 
from  the  command  file  to  the  DO  action  and  the  debugger  executes 
the  next  command  in  the  DO  action  (if  any). 


An  end-of-file  in  a  command  file  or  the  end  of 
equivalent  to  an  EXIT  command. 


a  DO  action   is 


If  the  command  stream  containing  the   EXIT  command 
from  the  terminal,  the  debugger  issues  its  prompt. 


was   invoked 


Poraat 


EXIT 


Cowiand  Parameters 


None 


CowBand  Qualifiers 


None 


Exanple 


DBG>  EXIT 
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GO 


GO 


Description 


Starts  or  continues  proqran  execution. 

If  the  GO  coflMnand  is  specified  without  an  address  expression, 
execution  resumes  at  the  current  proqra*  counter  value  (noraaily 
the  point  of  suspension)  or,  in  the  case  of  debugger  start-up,  at 
the  transfer  address. 

If  the  GO  coaMi«ind  is  specified  with  an  address  expression, 
execution  ri^Sijaes  at  the  location  specified  by  the  address 
expression.  You  should  be  cautious  when  you  use  the  GO  conaand 
vith  an  address  expression  because  the  GO  cosKnand  does  not  alter 
register  contents  or  the  stack;  it  si«ply  transfers  control  to 
the  designated  location. 

Execution  continues  until  one  of  the  following  occurs: 

•  The  user  progran  terminates. 

•  A  breakpoint  is  encountered. 

•  A  suspended  STEP  sequence  completes. 

e   The  debugger  detects  an  error  in  the  user  program. 


If  you  attempt  to  issue  the  GO  coramand  at  a 
location,  the  debugger  reports  an  error. 


nonresident   prograi 


Format 


GO  (addr-expr) 


CoflBand  Parameters 


addr-expr 


The  location  at  i(#hich  execution  resumes. 


Coaaand  Qualifiers 


None 


Exemple 


DBG>  GO 

routine  start  at  MAIN 

routine  break  at  SUBl 
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HELP 


HELP 


Description 


Displays  the  following  information  about  any  debugger  command: 
o   A  description  of  the  command 

•  Format  of  the  command 

•  Qjaliflera  that  may  be  specified  with  the  command 

•  Parameters^  that  may  be  specified  with  the  command 

The  HELJ^  cumiyiarv^  also  displays  information  about  other   selected 
topics: 

•  Terminating  tne  debugging  session 

•  Debugger  modes 

•  Debugger  types 


•      l>athna»e   format 


Fo  raa  t 


HELP   help-topic    [sub-topic  ...  1 


CoHiand   Parameters 


help-topic 

The  name  of  the  topic  for  which  you  need  help. 
sub-topic 

The  name   of  the  aubtopic  for  which  you  need  hel^^. 

CoMiand  Qualifiers 

None 

Example 

DBG>  HELP  DEFINE 
DEFINE 

Defines  a  symbol  and  assigns  it  an  address  for   the   duration 
debugging  session  (or  until  an  UNDEFIWE  command  is  executed). 

Format:   DEFINE  symbol'^expression 

Qualifiers:   None 

Additional  information  available: 

Parameters 


of   the 
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SET  BREAK 

Description 

Establishes  a  breakpoint  at  the  location  denoted  by  the  address 
expression. 

Mhen  a  breakpoint  is  activated,  execution  of  the  user  program 
suspends  before  the  instruction  at  the  breakpoint  is  executed. 
The  detjgger  prints  a  message  indicating  that  the  breakpoint  has 
been  reached. 

Either  an  address  expression  or  /CALLS,  but  not  both,  must  be 
specified.  If  /CALLS  is  specified,  it  must  be  the  only  command 
quelifler. 


Poraet 


SET   BREAK    [/qualifier...]     laddr-expr    {WHEN    (value-expr ) ]     (DO    (action)]) 
tend   Psreaeters 


addr-expr 


The  address  at  which  the  breakpoint  is  to  be  set. 


value-expr 


A  true/false  condition  evaluated  vhen  the  breakpoint  is  executed 
If  the  condition  is  false,  the  breakpoint  is  not  activated. 


action 


A  list  of  commands  delimited  by  parentheses  and  separated  by 
semicolons.  These  commands  are  executed  when  the  breakpoint 
occurs,  before  control  is  returned  to  the  current  command  stream. 

CoHiand  Qualifiers 


/AFTER :n 


Causes  the  breakpoint  not  to  occur  until  the  nth  and  subsequent 
activations  of  the  location  specified  by  the  address  expression. 
The  n  must  be  specified  as  a  decimal  integer. 

The  after  count  is  automatically  decremented  each  time  the 
location  is  activated. 

/AFTERsO  automatically  cancels  the  breakpoint  after  activation. 


/RETURN 


Sets  an  event  at  the  start  of  the  return  sequence  of  the   routine 
containing  the  address  expression. 


/CALLS 


Sets  a  breakpoint  at  all  JSR  and  RTS   instructions. 
qualifier   cannot   be   used   in  conjunction   with 
expression. 


txaaples 


The   /CALLS 
an  address 


D»G>  SET  SREAK/HETUMN  b'JB. 

DBG>  SET  SREAK  SUB:  •  !N£  2   IK#  -^ 
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SET  LOG 

SET  LOG 


Description 


N«M«8  th«  I09  file  to  %#hich  the  debugger  writes  its  output  and 
user  input  when  you  specify  the  LOG  parameter  with  the  SET  OUTPUT 
coMiand  • 

If  the  output  parameter  is  set  to  LOG,  but  no  log  file  has  been 
specified  by  means  of  the  SET  LOG  command,  the  debugger  writes  to 
the  file  DEBUG.LOG  by  default.  ^^:»  to 

IL^^T  '**^'*^2!I  is  currently  writing  to  a  log  file  and  you 
specify  m  SET  LOG  command,  the  debugger  closes  the  current  log 
file  and  begins  writing  to  the  file  specified  in  the  SET  LOG 
coamand.  if  the  file  specified  in  the  SET  LOG  command  already 
exists,  the  debugger  writes  to  the  file  specified,  appending  the 
log  of  the  debugging  session  onto  the  e  id  of  the  file.  If  the 
specified  log  file  does  not  exist,  it  is  created.  If  no  version 
number  is  specified  on  an  operating  system  ^ich  supports  version 
numbers,  a  new  version  is  always  created. 


The  debugger  assumes  a  default   file   type   of   LOG 
specified. 


if   none   is 


forset 


SET  LOG  file-spec 


Comaend  Pereaeters 


f  ile«-8pec 


A  file  specification  for  the  file  to  be  written. 


Coaaend  Quel i fie 


rs 


None 


Bxeaple 


DBG>  SET  LOG  DB0:LIST.LOG 
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SET  MODE 


D«scription 

Establishes  the  default  radix  and  the  default  symbol  mode. 

When  you  specify  a  radix  mode  with  the  SET  MODE  command,  the 
debi^gger  interprets  and  displays  all  integers  in  that  radix.  The 
radix  mode  specified  by  the  SET  MODE  command  may  be  overridden  by 
using  a  radix  mode  qualifier  with  the  EXAMINE  or  DEPOSIT 
commands. 


rorimat 


SET  MODE  mode  [ ,mode] 


Coaaand  ParaA«ters 


Bod« 


May  be  one  of  the  following: 

•  DECIMAL  —  sets  the  default  radix  to  decimal 

•  OCTAL  —  sets  the  default  radix  to  octal 

•  HEXADECIMAL  —  sets  the  default  radix  to  hexadecimal 

•  BINARY  —  sets  the  default  radi^  to  binary 
And  one  of  the  following: 

•  NOSYMBCL  —  displays  all  symbols  by  their  numeric  equivalents 

•  SYMBOL  —  displays  addresses  symbolically,  and  displays  the 
processor  status  word  and  the  floating-point  status  word  in  a 
formatted  style. 


CoMiand  Qualifiers 


None 


Example 


DBG>  SET  MODE  SYMBOL,  OCTAL 


S-28 


DEBUGGER  COMMANDS 
SET  OUTPUT 

SET  OUTPUT 


Description 


Specifies  the  way  in  which  debugger 
displu/ed  and  recorded. 


responses   to   commands   are 


You  can  direct  the  debugger  to  display  its  output  to  the  terminal 
or  to  a  log  file^  or  both.  You  can  also  direct  the  debugger  to 
include  in  its  output  each  coiamand  in  a  command  file  or  DO 
action. 


format 


SET  OUTPUT  parameter  (  ,parcimeter  .  .  . ) 


Coasand  Paraaeters 


paraa«t«r 


the   file 


May  be  one  of  the  following: 

•  LOG  *-  writes  the  debugger  output  and  user  input  in 
specified  in  the  SET  LOG  command 

•  NOLOG  —  stops  writing  to  the  .og  file 
And  one  of  the  following: 

•  TERMINAL  —  displays  the  debugger  output  on  the  terminal 

•  NOTERHINAL  --  Stops  displaying   the  debugger   output  on      the 
terminal 


And  one  of  the  following: 

•   VERIFY  —  includes  the  commands  read  from 
from  a  DO  action  in  the  debugger  output 


and   file   or 


NOVERIFY  —  does  not  include  the  cb— inds  re*^    froa  a 
file  or  fro*  &  DO  action  m  the  debugger  output 


coamand 


nd  Qualifiers 


Mone 


Example 


DK>   rt  C 


JT  V^Ki 


I  NAL  «  NoL'X 
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SET   SCOI»B 

SET  SCOPE 


Description 

Designates  a  program  location  to  be  used  in  interpreting  symbols 
that  are  specified  without  pathnames  in  debugger  commands. 

In  addition  to  scope  prefixes,  the  backslash  and  the  number  0  may 
also  be  used  as  parameters  with  the  SET  SCOPE  command.  The 
backslash  (\)  designates  that  symbols  without  pathnames  are  to  be 
interpreted  as  global  symbols.  The  u  represents  the  currently 
active  program  unit. 


Foraat 


SET  SCOPE  pathname 


CoMiand  Paraaeters 


pathnasa 


One  of  the  following: 

#  Scope  prefix  —  a  truncated  pathname  that  contains  a  list  of 
segment  names  (optional)  and  a  subprogram  or  MACRO-11  module 
name  in  the  format: 


t%SEG  name\[%SEG  name\. . . ] ] subprog ram 
0  —  the  currently  active  program  unit 

\  —  indicates   that   symbols  without   pathnames  are   to   be 
interpreted  as  global  symbols 


CoiuRand  Qualifiers 


None 


Exanple 


DBG>  SET  SCOPE  SUB1\SUB1 
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srr  STB 

SET  STB 


tescrlption 


Establishes  a  ;^ame  for  th#  STB  fil#.  The  STB  fiU  is  used  to 
resolve   pathnames  and  global  symbols.   The  default  STB  file  name 

?!^!  K  f?!"^  r  ^•^^^^•^  start-rp  is  the  STB  file  specified  in  the 
tasK  build  of  the  user  pro9raA. 

The  SCT  STB  coMand  also  causes  the  TKB  tiae  stanp  in  the  STB 
file  to  be  checked  acjainst  the  ti»e  sta»p  in  the  user  task  image. 
A  *#arni-ig  is  given  if  they  do  not  «atch.  ^ 


The  debugger  ass 
specified. 


u«es  a  default  file  type  of  STB   if 


no 


type   is 


format 


Mt  STB  file-spec 


CoMMnd  Paraaeters 


file- spec 


The  file  to  be  read. 


fid  Qualifiers 


None 


Exaaple 


DBG>  SET  STB  DEBUG. STB 
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SET  STEP 

Description 

Establishes  the  current  step  coaditions  to  be  used  by  the 
debugger  whenever  a  coouoand  qualifier  is  not  used  with  the  STEP 
coiiii<^nd . 

The  step  conditions  determine  if  the  debugger  steps  line-by-line 
of  Instruct  ion-by-instruction,  and  whether  the  debugger  steps 
•in'-o*  or  "over*  called  routines. 


Porsat 


SET  STEP  condition  [, condition) 


and  Paraaacers 


condition 


May  be  one  of  the  following: 

•   INSTRUCTION  —  A  single  step  causes  the  execution  of  a   single 
instruction  at  the  current  program  counter. 


•  LINE  —  A  single  step  causes  the  execution  of  all  the  user 
code  between  the  curient  location  and  the  next  statement 
boundary. 

And  one  of  the  following: 

•  INTO  —  steps  "into*  called  routines  in  the  user  program 

•  OVER  —  steps  "over*  called  routines  In  the  user  program 


CoMiand  Qualifiers 


None 


Exampla 


DBG>  SET  STEP  rMTO 
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SET  TRACE 


Description 


establishes  a  tracepoint  at  the  location  denoted  by  the  address 
expression.  When  a  tracepoint  is  activated,  program  execution  is 
not  suspended,  but  a  message  is  printed  indicating  that  the 
tracepoint  has  been  reached. 

Either  an  address  expression  or  /CALLS,  but  not  both,  must  be 
specified.  If  /CALLS  is  specified,  it  must  be  the  only  command 
qu/lif ier . 


For sat 


SET  TRACE    [/qualifier...]    addr-expr    [WHEN    ( value-expr ) ]     [DO    (action)l) 
Co«Mind  ParMietars 
addr-expr 


The   address   at   which    the   breakpoint    is    to   be    set. 


value«-expr 


A  true/false  condition  evaluated  when  the  tracepoint  is  executed. 
If  the  condition  is  false,  the  event  is  not  activated. 

action 

A  list  of  commands  delimited  by  parentheses  and  separated  by 
semicolons.  These  commands  are  executed  when  the  tracepoint 
occurs,  before  control  is  returned  to  the  current  command  stream. 

CoMiand  Qualifiers 

/AfTBPl:nJ 

Causes  the  tracepoint  not  to  occur  until  the  nth  and  subsequent 
activations  of  the  location  specified  by  the  address  expression. 
The  n  must  be  specified  as  a  decimal  integer. 

The  after  count  is  automatically  decremented  each  time  the 
location  is  activated. 

/AFTERiO  automatically  cancels  the  tracepoint  after  activation. 
/RETURN 


Sets  a  tracepoint  at  the  start  of   the   return 
routine  containing  the  address  expression. 


sequence   in   the 


/CALLS 


Sets  an  event  at   all   JSR   and   RTS   instructions, 
qualifier   cannot   be   used   in  conjunction  with 
expression. 


The   /CALLS 
an   address 


Examples 


DBOSET  TRACE/CALLS 


DBOSET  TRACE/RETURN  SUBi\SUBl 
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SET  TYPE 

Description 

Establishes  the  default   type 
progran  locations. 


to   be  associated   with   untyped 


Types  specified  as  command  qualifiers  override  types  specified  in 
SET  TYPE  commands. 


format 


SET  TYPE  type 
CoMiand  Parameters 


type 

One  of  the  following: 

•  BYTE  —  The  type  byte  integer  (length  one  byte). 

This  type  is  equivalent  to  FORTRAN-77  '^YTE  and  L0GICAL*1. 

•  WORD  —  The  type  word  integer  (length  two  bytes) . 

This  type  is  equivalent  to  FORTRAN-77  INTEGER*2  and  L0GICAL*2. 

•  LONG  —  The  type  long  integer  (length  four  bytes). 

This  type  is  equivalent  to  FORTRAN-77  INTEGER*4  and  L0GICAL*4. 

•  FLOAT  —   The   type   single-precision   floating-point   number 
(length  four  bytes). 

This  type  is  equivalent  to  FORTRAN-77  REAL*4. 

•  D  FLOAT  —  The   type   double-precision   floating-point   number 
(length  eight  bytes) . 

This  type   is   equivalent   to   FORTRAN-77   REALMS   and   DOUBLE 
PRECISION. 

•  ASCII [:n)  —  The  type  ASCII  of  length  n  bytes.  The  value  n  is 
interpreted  in  decimal  radix.  If  n  is  omitted,  the  debugger 
assumes  a  default  value  of  two  bytes. 

This  type  is  equivalent  to  FORTRAN-77  CHARACTER* 1 en . 

•  INSTRUCTION  —  The  type  instruction  whose  length  is  variable, 
df   nding  on  the  number  of  instruction  operands. 

This  type  is  equivalent  to  MACRO-11  instructions. 

•  RAD50  —  The  type  RAD50  (length  two  bytes). 
This  type  is  equivalent  to  Radix-50. 

CoHiand  Qualifiers 

None 

Sxaaple 

DBG>  SET  TYPE  RAD50 
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SHOM  ALL 


SHOW  ALL 


Description 


Displays  all  breakpoints  and  tracepoints  currently  in  effect,  and 
the  current  mode,  type,  output  configuration,  scope,  and  step 
conditions. 


Format 


SHOW  ALL 


CoMiand  Paraa«t«rs 


None 


Comiand  Qualifiers 


None 


BviiBple 


DBG>    SHOW   ALL 
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SHOM  BREAK 

SHOW  BREAK 

Description 

Causes  the  debugger  to  display  the  breakpoints 
BREAK  conmand. 


set   by   the   SET 


If  an  address  expression  is  given,  only  the  breakpoint  denoted  by 
the  address  expression  is  displayed. 


Foraat 


SHOW  BREAK  [addr^expr] 


Coaaand  Parameters 


addr-expr 


The  address  of  the  breakpoint  to  be  displayed 


CoMiand  Qualifiers 


Nona 


Bxaapla 


OBG>  SHOW  BREAK 

breakpoint    at    RtAINMLINE    12 

breakpoint    at    SUB1\%LINE    44-12 
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SHOW  CALLS 


Description 


Causes  the  debugger  to  display  for«ation  about  the  sequence  of 
currently  active  procedure  calls. 

The  optional  call  count  parameter  is  a  decimal  integer  that 
specifies  the  number  of  calls  to  be  displayed.  If  you  do  not 
specify  a  value  for  call-count,  information  for  all  calls  on  the 
stack  is  displayed. 


ForBat 


SHOW   CALLS    [call'Countl 


CoMiand   Paraaeters 


call-count 


The  number  of  calls  to  be  displayed 


Comand  Qualifiers 


None 


Example 


DBG>  SHOW  CALLS 

module  name    routine  name    line 
SUB2  SUB2 

SUBl  SUBl  5 

MAIN  MAIN         1" 


relative  PC 
00.':)002 
001020 
000426 


absolute  PC 
012340 
003426 
001232 
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SHOM  LOG 


SHOW  LOG 


i>e9cr  iption 


Causes  the  debu99er  to  dis(>lay  the  name  of  the  current 
Mtid    to  report  %#hether  it  is  ^iritinq  to  the  I09  file. 


I09   file 


Format 


SHOW  LOG 


CoMiand  Parameters 


None 


CoMiand  Qualifiers 


None 


Exaaple 


DBG>  ?mrm   log 

not  logging  to  •SVO : (101 , 33) DEBUG. LOG" 
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SHOM  HODB 

SHOW  MODE 


Description 


Causes  the  debugger  to  display  the  current   radix  node   and   the 
current  symbol  mode* 


The  current  modes  are  either  the  defaults  or 
most  recent  SET  MODE  command. 


these   set   by   the 


for»«t 


SHOW  MODE 


Command  Parameters 


None 


Command  Qualifiers 


None 


Example 


DBG>  SHOW  MODE 

modes:  symbolic,  decimal 
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SHOW  OUTPUT 


Description 


current  output  configuration. 
The  output  configuration  reflects  whether  the  debugger  is 
displaying  output  on  the  terminal  or  writing  output  to  a  log 
file,  and  whc*'her  the  debugger  displays  input  command  strings 
wh( 


Format 


SHOW  OUTPUT 


Comand  Parameters 


None 


CoMiand  Qualifiers 


None 


Cxanple 


DBG>  SHOW  OUTPUT 

output:  noverify,  terminal,  not  logging  to 


SYO: [101, 331DEBUG.LOG 
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SHOW  SCOPE 


Description 

Causes  tne  debugger  to  display  the  current  default  SCOPE  path 
Porsat 

SUOM  SCOP£ 

CoMMnd  Peraaeters 
None 


Coasand  Qualifiers 


None 


Exaaple 


DBG>  SHOM  SCOPE 
scope:  SUBl 
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SBOM  STB 


SHOW  STB 


Description 


Causes  the  debugger  to  display  the  name  of  the  current  STB  file. 

The  current  STB  file  Is  either  the  initial  STB  file  specified   in 

the   task   image  or   the   file   specified  by  the  roost  recently 
executed  SET  STB  coBimand. 


Format 


SHOM  STB 


Coasand  Parameters 


None 


CoMand  Qualifiers 


None 


Exaaple 


DBG>  SHOW  STB 
current  STB  file  is 


•SYO;  1101,33]EXAMPLE.STB 
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SHOW  STEP 


Description 

Causes  the  debugger  to  display  the  current  step  conditions. 
format 

SHOW  STEP 

CoMutnd  Paramatars 


None 


Qualifiers 


Non( 


Bxaapla 


DBG>  SHOW  STEP 

step  type:  by  line,  into  routine  calls 
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SHOM  TRACE 


SHOW  TRACE 


Osscription 


Causes  the  debugqei  to  display  the  trdcepoints 
TRACE  cownand. 


set   by   the   SET 


If  an  address  expression  is  given,  only  the  tracepoint  denoted  by 
the  ad    ss  expression  is  displayed. 


Foraat 


SHOW  TRACE  [addr-expr] 


CoBAand  Paras«tai*8 


addr-axpr 


The  address  of  the  tracepoint  to  be  displayed 


Conaand  Qualifiars 


None 


Bxaaple 


DBOSHOW  TRACE 

tracepoint  at  MAIN\%LIME  4 
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DEBUGGER  COMMANDS 
SlOU  TYPE 

SHOW  TYPE 


Description 

Causes  the  debugger  to  display  the  current  type 
forsat 

SHOW  r/PE 

CoMiaruS   Parameters 

None 


CooMiand   Qualifiers 


None 


Exaaple 


DBG>  SHOW  TYPE 
type;  word  integer 
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DBSUGG»   COflMAMDS 
STEP 


STEP 


Description 


Causes  the  debugger  to   execute  one   line  or   one   instruction, 
depending  on  the  current  step  conditions. 


When  you  issue  a  STEP  coinmand,  the  debugger  takes   the   followi 
action; 


ng 


t   Reports  the  next  instruction  or  line  to  be  executed 

•  Executes  an  instruction  or   set  of   instructions   from  your 
prog  ran 

•  Reports  the  line  or  instruction  following  the  last  instruction 
executed 

•  issues  its  prompt 

Any  number  of  step  sequences  may  be  in  effect  at  one   time;    the 
sequences  execute  independently  and  simultaneously. 

If  you  specify  step-count  as  a  parameter  in  the  STEP  command,  the 
debugger  executes  step-count  lines  or  instructions. 


You  can  override  current  step  conditions   by   specifying 
condition  as  a  command  qualifier  with  the  STEP  command. 

The  debugger  continues  executing  the  user  program   until 
the  following  occurs: 

e   Any  STEP  sequence  is  complete. 

e   A  breakpoint  or  tracepoint  occurs. 

e   The  debugger  detects  a  user  program  error. 


The  jser  program  execution  is  complete. 


Fonset 


step 


one   of 


STEP  [/qualifier...]  [step-count] 


CoMiand  Paraaeters 


step-count 


A  decimal   integer   that   specifies   the   number 
instructions  to  be  executed  by  the  STEP  command. 


of   lines   or 


Coaasnd  Qualifiers 
/INSTRUCTION 

A  single  step  causes  the  e.ecution  of  a  single  instruction  at  the 
current  program  counter. 


• 
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STf 


/LINE 


A  single  step  causes  the  execution  of  all  the  user  code  between 
the  current  location  and  the  next  statement  boundary.  If  LINE  is 
specified  and  no  line-number  information  is  available  for  the 
current  module,  a  warning  message  will  be  displayeO  and 
instruction-node  steppin<j  will  be  done* 


/INTO 


Steps  •into"  called  routines  in  the  user  program. 


/OVER 


Steps  "over*  called  routines  in  the  user  program. 


Examples 


DBG>  STEP 

start  at  MAIN\%LINE  4 

stepped  to  MAIN\%LINE^  5 

DBOSTEP/INTO  4 

start  at  MAIN\«LINE  4 

stepped  to  15244:   MOV   (%R5) ,%R2 
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UNDBPIMB 


UNDEFINE 


Description 


The  UNDEFINE  command  removes  a  symbol  from  the  table 
symbols. 


of  defined 


foraat 


UNDEFINE  symbol 


CoHMnd  Parameters 


symbol 


The  name  of  a  symbol  which  was  previously  defined   in  a  DEFINE 
command. 


Command  Qualifiers 


None 


Example 


DBG>  UNDEFINE  buffer 
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APPENDIX  A 


EXAMPLE  PROGRAM 


A.l   PROGRAM  EXAMPLE 

The  following  FORTRAN-77   program   is   used   to 
Section  3.2.2  that  illustrate  the  STEP  command: 


explain   examples   in 


C 
C 
C 


PERFORM  SOME  SIMPLE  STATISTICS  ON  A  SET  OF  DATA 


0001 

0002 
0003 
0004 
0005 


0006 


0007 


0008 


0009 

0010 
0011 


PROGRAM  EXAMPL 

PARAMETER  (ICOUNT-10) 

REAL  MEDIAN 

DIMENSION  VECTOR (ICOUNT) 

DATA  VECTOR/ 10. ,12. ,8. ,14. ,6. ,16. ,4. ,18. ,2. ,20/ 

COMPUTE  THE  AVERAGE 

PRINT  *,AVERGE (VECTOR, ICOUNT) 

SORT  THE  VALUES  INTO  ASCENDING  ORDER 
CALL  SORT(VECTOR, ICOUNT) 

COMPUTE  THE  MEDIAN 

PRINT  ♦, MEDIAN (VECTOR, ICOUNT) 

COMPUTE  THE  RANGE 

PRINT  ♦,VECT0R(IC0UNT)-VECT0R(1) 

STOP 
END 


C 

c 


COMPUTE  THE  AVERAGE  OF  THE  VALUES  IN  AN  ARRAY 


0001 
0002 

0003 

0004 
0005 

0006 

0007 
0008 


10 


FUNCTION  AVERGE (VALUES, MAXDIM) 
DIMENSION  VALUES  (MAXDIM) 


AVERGE 


0.0 


DO  10  INDEX  »  1,  MAXDIM 

AVERGE  ^    AVERGE  >  VALUES ( INDEX) 

AVERGE  »  AVERGE/REAL (MAXDIM) 

RETURN 
END 
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EXAMPLE  PROGRAM 
PROGRAM  EXAMPLE 


C 

e 
e 


THIS  FUNCTION  COMPUTES  THC  MEDIAN  OP  THE  ARRAY  'VALUES' 


0001 
0002 


0003 
0004 
OOOS 
0006 
0007 


REAL  FUNCTION  MEDIAN (VALUES ,MAXDIM) 
DIMENSION  VALUES (MAXDIM) 

COMPUTE  THE  MEDIAN 

IF  (M0D(MAXDIM,2)  .EQ.  0)  TK2N 

MEDIAN*  (VALUES  (MAXDIM/2'H  )  -LVALUES  lMAXDIM/2  )  )  /2 
ELSE 

MEDIAN«VALUES(MAXDIM/2) 
ENDIF 


0008 
0009 


RETURN 
END 


0001 
0002 
0003 


c 
c 


SORT  THE  ELEMENTS  OF  THE  ARRAY  'VALUES'  INTO  ASCENDING  ORDER 


SUBROUTINE  SORT  (VALUES , MAXDIM) 
DIMENSION  VALUES (MAXDIM) 
LOGICAL  DONE 


0004 
0005 
0006 
0007 
0008 
0009 
0010 
0011 
0012 


10 


20 


DONE  »  .TRUE. 

DO  20  INDEX  =»  1,  MAXDIM-1 

IF  (VALUES (INDEX)  .GT.  VALUES ( INDEXED )  THEN 
SWITCH  '    VALUES (INDEX) 
VALUES (INDEX)  =  VALUES ( I NDEX-H  ) 
VALUES  (INDEX-H)  ^    SWITCH 
DONE  =  .FALSE. 
ENDIF 
CONTINUE 


0013 


IF  ( .NOT.  DONE)  GOTO  10 


0014 
0015 


RETURN 
END 
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APPENDIX  B 
PDP-11  FORTRAN- 7 7  DEBUG  ERROR  MESSAGES 


AFTTOBIG,  AFTER  count  too  large 

Bxplanationi    The  delay  specification    in 
tracepoints  is  limited  to  a  maximum  of  255. 


breakpoints   and 


User  Action:   Reduce  the  delay  specification  to  a  valid  value. 


AMBIG,  ambiguous  key%#ord 

Explanation:    The   keyword   specified   is   an   abbreviation   for 
several  keywords  that  are  valid  at  this  point. 

User  Action:   Make  the   abbreviation  unique  by   increasing   its 
length. 

ASCTOOBIG,  ASCII  type  must  be  less  than  256  bytes 

Explanation:   The  number  of  characters  in  the  ASCII   string  must 
lie  between  1  and  255,  inclusive. 

User  Action:   Reduce  the  number  of  characters. 

BADINDEX,  index  cannot  be  an  array 

Explanation:   An  unsubscr ipted  array  name  was  used   as   an   array 
subscript. 

User  Action:   Correct  the  expression  and  reenter  the  command. 

BADINS,  illegal  opcode 

Explanation:   The  debugger  encountered  an  unexpected  error. 
User  Action:   File  a  Software  Performance  Report. 
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BADRADSO,  the  string  "'string' •  contains  non-RAD50  characters 

Explanation:  The  specified  string  must  contain  valid  Radix-50 
characters. 

Usar  Action:  Consult  the  PDP-11  FORTRAN- 7 7  Language  Reference 
Manual  for  valid  Radix-50  characters, 

BADRANOE,   address   range   'address'   to   'address'   is   invalid   (not 
ascending) 

Explanation:  The  addresses  must  be  specified  in  order  from 
lowest  to  h'jhest. 

Usar  Action:   Correct  the  specification. 

BAOREGUSC,  register  name  may  not  be  used  in  this  context 

Explanation:  Regisrter  names  are  invalid  in  certain  address 
contexts.  Examples  are  execution  start  addresses,  breakpoint  and 
tracepoint  addresses. 

Usar  Action:   Specify  an  address  that  is  not  a  register. 


BAD_INSTRUCT,  unable  to  decode  PDP-11  instruction  at  'address' 

Explanation:    'Address'   does   not   start   a   valid   PDP-11 
instruction. 

Usar  Action:  None. 


BAD^NAME,  bad  file  name 

Explanation:   The  file  system  has  detected  a  syntax  error  in   the 
rile  specification. 

User  Action:   Correct  the  file  specification. 

BAD_PATH,  "'pathname**  does  not  begin  a  valid  pathname 

Explanation:   Incorrect  pathname  syntax. 

Usar  Action:   Consult  the  PDP-11  FORTRAN -7 7   DEBUG   User's  Guide 
for  correct  pathname  syntax. 

BAD^SCOPE,  invalid  numeric  scope 

Explanation:   The  only  numeric  scope  recognized  by   the   debugger 
is  0-scope. 

Usar  Action:   Consult  the  PDP-11  FORTRAN-77   DEBUG   User's  Guide 
for  information  on  specifying  scope. 
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BAD_STAMP,  time  stamp  d-^Ls   tot   match 

Explanation:   The  rinie  su^mp  written  in  the   STB  file  does  not 

match   the   time  stamp  written  in  the  task  image  being  debugged. 

This  indicates  that  the  two  files  were  not  creuted  by  the   same 
task  build. 


User  Action:   Use  SET  STB  'file-name'  to  access  the  correct   STB 
file. 


BADSTB,  invalid  STB  file 

Explanation:   The  file  specified  in  the  SET  STB  corr;?nand   has  an 
invalid  format. 

User  Action:   Specify  the  proper  file  name   in   the   SET  STB 
command. 


BAD_STB,  invalid  nesting  of  FORTRAN  routines 

Explanation:   The  debugger  has  detected  an  error  ^ 
table  file. 

User  Action:   File  a  Software  Performance,  Report. 


the   symbol 


BAD_SYMBOL^  deposit  past  end  of  'symbol' 

Explanation:  An  attempt  was  made  to  deposit  into  one  of  the 
debugger  permanent  symbols  with  a  data  length  greater  than  that 
of  the  permanent  symbol. 

User  Action:   Correct  and  reenter  the  command. 


BAD_SYMBOL,  examine  past  end  of  'symbol' 

Explanation:  An  attempt  was  made  to  examine  one  of  the  debugger 
permanent  symbols  with  a  data  length  greater  than  that  of  the 
permanent  symbol. 

User  Action:   Correct  and  reenter  the  command. 


BAD_TBIT,  unexpected  T-bit  trap 

Explanation:   A  CTRL/C  was  typed  during  execution  of  a  debugger 
command. 

User  Action:   None. 


BAD_WHEN,  WHEN  expression  is  of  invalid  type 

Explanation:   The  expression  in  a  WHEN  clause  must  be 
LCXSICAL  type  or  INTEGER  type. 


of   either 


User  Action:   Consult  the  PDP-11  FORTRAN-77   DEBUG   User's  Guide 
for  information  about  the  WHFN  clause. 
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BREAK_BAD_ADDR,  address  is  unknown  to  debugger 

Explanation:    An  error  occurred  searching   the   STB 
Additional  message(s)  will  appear  giving  more  details. 

Usar  Action:   None. 


file 


CONVERR,  index  could  not  be  converted  for  dimension  'number' 

Explanation:  A  conversion  error  occurred  evaluating  a  subscript 
expression.  Additional  message(s)  will  appear  giving  more 
details. 

User  Action:   None. 

CTRLC,  unexpected  CTRL/C 

Explanation:  A  CTRL/C  was  typed  during  execution  of  a  debugger 
command. 

User  Action:   None. 


DATA_LOST,  previously  opened  LOG  file  cannot  be  reopened,  data  will  be 
lost 


Explanation:   The  debugger  was  unable  to  open  the   LOG 
Additional  message(s)  will  appear  giving  more  details. 

User  Action:   None. 


file 


DEPTOOLONG,  DEPOSIT  buffer  overflow 

Explanation:   The  DEPOSIT  command  is  limited  to  a  total   of   ICO 
bytes  of  data. 

User  Action:   Partition  the  DEPOSIT  command  into  several   deposit 
commands. 

DIMENERR,  number  of  indexes  given  does  not  match  dimension 

Explanation:   An  array  reference  used  an   incorrect  number  of 
dimensions. 

Uiei  Action:   Correct  the  expression  and  reenter  the  command. 

DISABLED,  the  recognition  of  'event'  is  disabled 

Explanation:   A  DISABLE  BREAK  or  a  DISABLE  TRACE  command   is   in 
effect. 

User  Action:   Use  the  ENABLE  BREAK  or   ENABLE   TRACE  command   to 
reverse  the  effect  of  the  DISABLE  command. 


H 
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EMT,     illegal    EMT 

Explanation:   The  debugger  encountered  an  unexpected  error 
User  Action:   File  a  Software  Performance  Report. 


ENABLED,  the  recognition  of  'even*.'  is  enabled 

Explanation:   An  ENABLE  BREAK   or   ENABLE   TRACE   command   is   in 
effect. 

Usar  Action:   None. 


EXTOOLNG,  you  can  only  EXAMINE  up  to  'number*  bytes  at  once 

Explanation:   A  single  EXAMINE  may  only  display   100   bytes  of 
data. 

User  Action:   Break  the  command  into  2  or  more  separate   EXAMINE 
commands. 


FCS_ERR,  FCS  error  code  is  'number' 

Explanation:   The  FCS  file  system  has  detected  an  error. 

User  Action:   Consult  the   lAS/RSX-ll   I/O  Operations  Reference 
Manual  for  an  explanation  of  the  error  code. 


PILE_ERR,  error  on  'type  of  file  'file-operation' 

Explanation:   An  error  occurred  in  a  file  operation. 
message(s)  will  give  details  on  the  error  encountered 

User  Action:   None. 


Additional 


FLTDIV,  floating  point  divide  by  0 

Explanation:   The  debugger  attempted  to  divide  by  0. 

User  Action:   Correct  the  expression  and  reenter  the  command 


FLTOVF,  floating  point  overflow 

Explanation:     A   floating-point   overflow   occurred   during 
evaluation  of  an   expression. 

User  Action:   Correct  the  expression  and  reenter  the  command. 


FLTUND,  floating  point  underflow 

Explanation:    A   floating-point   underflow   occurred   during 
evaluation  of  an  expression. 

♦ 

User  Action:   Correct  the  expression  and  reenter  the  command. 
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FPOP,  invalid  floating  point  operation 

Explanation:   The  debugger  attempted  to  evaluate  a  floating-point 
expression  on  a  machine  without  a  floating-point  unit. 

User  Action:   None. 


FPUND,  undefined  floating  point  variable 

Explanation:   An  expression  contained  a  variable  whose  value   was 
the  undefhied  value. 

User  Action:   Correct  the  expression  and  reenter  the  command. 


FP_ERR,  floating  point  error 

Explanation:   The  debugger  encountered  an  unexpected  error 
User  Action:   File  a  Software  Performance  Report. 


HELP_FMT,  length  error  in  following  keyword: 

Explanation:   The  debugger  HELP  file  is  corrupt. 
User  Action:   File  a  Software  Performance  Report, 

ILL_NUM,  "'numeric-string'"  is  not  a  valid  base-' radix*  number 

Explanation:   The  'numeric-string'   is  specified   in   the   wrong 
radix. 

User  Action:   Use  the  SHOW  MODE  command  to  determine  the   correct 
radix  and  respecify  'numeric-string'. 


INISTBNAM,  TKB-specified  STB  file  is  "'file-name 


I  N 


Explanation:    The  STB   file  created 
"'file-name'". 

User  Action:   None. 


during   task-build   is 


INPCONERR,  input  conversion  error 

Explanation:   A  floating-point  number  must  be  a   real   constant 
with  a  decimal  point. 

User  Action:   Consult  the  PDP-11   FORTFAN-77   Language  Reference 
Manual  for  information  about  real  numbers. 


INTDIV,  integer  divide  by  0 

Explanation:   The  debugger  attempted  to  divide  by  0. 

User  Action:   Correct  the  expression  and  reenter  the  command. 
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INTERROR,  'message  text' 


Explanation:   The  debugger  has  detected  an  internal  coding  error. 
User  Action:   File  a  Software  Performance  Report. 

INTOVF,  integer  overflow 

Explanation:   An  integer  overflow  occurred  during  evaluation  of 
an  expression. 

User  Action:   Correct  the  expression  and  reenter  the  command. 

INTRPT,  unexpected  interrupt 

Explanation:   An  interrupt  has  occurred   during   execution  of  a 

debugger   command.   Additional  message(s)  will  apoear  qivinq  more 
details,  r .  ^  ^ 

User  Action:   None. 


INVCHAR,  illegal  character 

Explanation:   A  command  line  contained  an  illegal  character. 
User  Action:   Correct  the  command  and  reenter  it. 

INVDIM,  subscript  error,  'array  nai.e'  has  dimension  'dimension  list' 

Explanation:   An  array  reference  has  one  or  more  dimensions  out 
of  range. 

User  Action:   Correct  the  reference  and  reenter  the  command. 


INVLINE,  invalid  line  number  'line' 

Explanation:   Line  numbers  must  be  less  than  32768. 

User  Action:   Respecify  the   command,   giving   the  correct   line 
number . 


INVTYPE,  invalid  data  type 

Explanation:   The  debugger  has  detected  an  error  in  the  STB  file. 
User  Action:   File  a  Software  Performance  Report. 

INFUSE,  file  is  already  in  use 

Explanation:   The  specified  file  is  locked  by  another  task. 
User  Action:   Ensure  that  the  file  is  available  for  use. 
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lOT,  lOT  instruction  executed 

Explanation:   The  debugger  encountered  an  unexpected  error. 
User  Action:   File  a  Software  Performance  Report. 


LINNOTFND,  search  failed  for  %LINE  'line-number' 

Explanation:   No  such  line  number  exists  in  your  program. 
User  Action:   Verify  the  correct  line  number  and  respecify  it, 

LINTOBIG,  command  line  too  long 

Explanation:   A  command,  including  all   continuation   lines,   is 
limited  to  256  characters. 

User  Action:   Simplify  the  command. 

MEM_PROT,  memory  protect  error 

Explanation:   The  debugger  encountered  an  unexpected  error. 
User  Action:   File  a  Software  Performance  Report. 

MIXED_TYPE,  unable  to  EXAMINE  an  address  range  of  mixed  type 

Explanation:   Entities  in  the  specified   address   range  must  be 
either  program  addresses  or  register  addresses. 

User  Action:   Specify  an  address  range  of  one  type. 

NAMTOBIG,  the  name  "'name'"  has  'length*  characters 

Explanation:   Symbol  name  must  not  exceed  6  characters. 
User  Action:   Specify  the  name  correctly. 

NOEVENT,  tiiere  is  no  'event'  at  'address' 

Explanation:   No  breakpoint  or  tracepoint  has  been  set  at  the 
specified  address. 

User  Action:   Use  the  SET  BREAK  or  SET  TRACE  command   to   set   an 
event. 


NOEVESET,  there  is  no  'event'  currently  set 

Explanation:   No  breakpoints  or  tracepoints  are  in  effect. 
User  Action:   None. 
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a 


NOMOD,  0-SCOPE  is  invalid  for  tnis  PC 

Syplanation:  The  current  PC  does  not  lie  within  the  bounds  of  a 
subprogram  compiled  with  the  DB  option. 

User  JACtion:   Specify  a  full  prthname  tor  the  symbol. 

HO  lED,  'address*  has  no  predecessor 

Explanation:  Logical  predecessor  is  defined  only  tor  elements  of 
arrays,  untyped  storage  locations,  instructions,  and  PDP-11 
machine  registers. 

User  Action:   Specify  one  of  the  above. 

NOQUOTE,  string  literal  missing  closing  q^ote 

Explanation:  String  literals  must  be  enclosed  by  quotation 
marks. 

User  Action:   Respecify  with  the  closing  quote. 


NOSUCC,  'address*  has  no  successor 

Explanation:  Logical  successor  is  defined  cnly  for  elements  of 
arrays,  untyped  storage  locations,  instructions,  and  PDP-11 
machine  registers. 

User  Action:   Specify  one  of  the  above. 


NOTARRAY,  subscripted  variable  "'name'"  is  not  an  array 

Explanation:   A  subscripted  variable  must  be  an  a- ray. 

User  Action:   Correct  the  expression  and  reenter  the  command 


NOTDEFINE,  you  do  not  have  a  defined  symbol  "'name'" 

Explanation:   Tlie  debugasr  does  not  recognize  •  ame*  as  a  symbol. 
User  Action:   Use  the  DEFINE  command  to  define  'name'. 


NOTLINKED,  STB  record  has  not  been  processed  by  TKB 

Explanation:   The  STB  file  contains  records  that  have   not   been 
processed  by  the  Task  Builder. 

User  Action:   File  a  Software  Performance  Repc  t. 


NOTRES,  *^ddress'  is  not  resident 

Explanation:   An  address   specified   in   an   EXAMINE  or   DEPOSIT 
coaiinand  ^efers  to  an  overlay  segment  not  curr  mtly  in  r.emoiy. 

User  Action:   None. 
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NOT_GSD,  unable  to  locate  "'name'"  as  GSD 

Explanation:   The  specified  'name*  could  not  be  found  as  a  global 
symbol . 

User  Action:   Consult  the  PDP-11  FORTRAN- 7 7   DEBUG  User's  Guide 
for  information  on  pathnames. 


NONACTION,  unable  to  link  in  action  "'action'" 

Explanation:   The  debugger  could  not  obtain  sufficient  storage  to 
execute  the  indicated  action. 

User  Action:    Regain  dynamic  memory  by  eliminating   unneeded 
breakpoints. 


NO_CALLS,  there  are  no  active  call  frames 

Explanation:   There  are  no  FORTRAN  subprograms  currently  active. 


f  ? 


ser  Action:   None. 


NO_CONV,  unable  to  convert  datatypes 

Explanation:   A  DEPOSIT  commanc*  attempted  to  convert  numeric  data 
to  character^  or  character  data  to  numeric. 

User  Action:   Correct  the  command  and  reenter  it. 

!.'0_DIR,  directory  does  not  exist 

Explanation:    Thr  directory  specified   as  part  of   the   file 
specification  does  not  exist. 

User  Action:   Correct  the   tile  specification  ana   reenter  the 
command. 


NO_FILE,  file  does  not  exist 

Explanation:   The  specified  file  does  not  exist. 

User  Action:   Correct  the   file  specification  and   reenter  the 
command • 


NO_LOG,  unable  to  open  log  file  "'file  name'" 

Explanation:   The  debugger  is   unable   to  open  the 

Additional  mess.^ge(s)  will  app^^ar  giving  more  details 

User  Action:   None. 


LOG   file 


NO_PATHNAME,  unable  to  find  'name'  in  STB  file 

Explanation:   The  debugger  does  not  recognize  'name'  as  a  symbol. 

User  Action:   Consult  PDP-11  FORTRAN-77  DEBUG  User's  Guide  for 
information  on  palhiiame  syntax. 


B-10 


PDP-11  PORTRAN-77  DEBUG  ERROR  MESSAGES 


NO_READ,  no  read  access  to  address  'address' 

Explanatioi:   The  debugger  was  unable   to   read  the  specified 
address* 


User  Actions   None. 


NO  REAL,  logical  operations  are  not  legal  for  REAL 


Explanation:   Logical  operations  can  be  performed  only  on  logical 
or  integer  expressions. 

User  Action:   None. 


NO_SCOPE,  0-SCOPE  is  invalid  for  this  PC 

Explanation:    The  current  PC  is  not  within  a  program 
subprogram  compiled  with  the  DEBUG  option* 

User  Actions   Specify  a  pathname  for  the  symbol. 


or 


NO_SPACE,  internal  storage  exhausted 

Explanation:  The  debugger  could  not  obtain  sufficient  dynamic 
memory  to  perform  the  command. 

User  Action:  Regain  dynamic  memory  by  eliminating  unneeded 
breakpoints. 

NO_STB_FILE,  no  STB  file  is  currently  set 

Explanation:  A  SHOW  STB  command  was  issued  when  no  STB  file  was 
set. 

User  Action:   None. 

NO_WHEN,  unable  to  link  in  condition  "'when  clause'" 

Explanation:  The  debugger  could  not  obtain  sufficient  storage  to 
evaluate  the  specified  condition.  The  condition  is  treated  as 
though  it  evaluated  to  TRUE. 

User  Action:  Regain  dynamic  memory  by  eliminating  unneeded 
breakpoints. 

NO^WRITE,  no  write  access  to  address  'address' 

Explanation:  The  debugger  was  unable  to  write  to  the  specified 
address. 

User  Action:   None. 


ODDBPT,  you  may  not  set  an  'evint'  at  odd  address  'address* 

Explanation:   You  cannot  set  a  breakpoint  or  tracepoint  at  an  odd 
address. 

User  Action:   Correct  the  address  and  respecify  it. 


B-11 


PDP-11  PORTRAN-77  DEBUG  ERROR  MESSAGES 


ODD_ADDR,  odd  address  trap 

Explanation:   The  debugger  encountered  an  unexpected  error 
User  Action:   File  a  Software  Performance  Report. 


• 


OPERSTOVFL,  operand  stack  overflow 

Explanation:   The  parser  has  exhausted  its  operand  stack. 
User  Action:   Reduce  the  complexity  of  the  command. 

OPSTOVFL,  operator  stack  overflow 

Explanation:   The  parser  has  exhausted  its  operator  stack. 
User  Action:   Reduce  the  complexity  of  the  command. 

OUTCCNERR,  output  conversion  error 

Explanation:    The  debugger  was  unable   to   format  the  value 
requested. 

User  Action:   Pile  a  Software  Performance  Report. 

OUTPUTi OST,  output  being  lost,  both  NOLOG  and  NOTERM  are  in  effect 

Explanation:   The  SET  OUTPUT  command  has  been  specified  with  both 
NOLOG  and  NOTERM  parameters. 

User  Actic^:   Specify  the  SET  OUTPUT  command  with  either  the   LOG 
or  TERM  parameter. 


PERM__DEF,  you  cannot  redefine  the  permanent  symbol  'name' 

Explanation:   A  permanent   symbol   cannot  be  defined  with  the 
DEFINE  command. 

User  Action:   Consult  the  PPP-ll  FORTRAN-??   DEBUG  User*s  Guide 
for  a  list  of  permanent  symbols . 


PROTECTED,  file  has  restricted  access 

Explandtion:   The   file   specified   in   the   current  command   is 
protected  against  access  by  the  debugger. 

User  Action:   Correct  the  file  protection. 

PRSTOVFL,  parse  stack  overflow 

Explanation:   The  parser  has  exhausted  its  parse  stack. 
User  Action:   Reduce  the  complexity  of  the  command. 
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RECTOBIG,  record  was  truncated 


Explanations 
bytes. 


The  command  file  contained  a  record  larger  than  255 


User  Action:   Correct  the  command  file. 


RETURN_BREAKs,  can  only  refer  to  a  routine 


Explanation:   The  address  specified  with  SET  BREAK/RETURN  must  be 
within  a  FORTRAN  main  program  or  subprogram. 

User  Action:   Correct  the  address  and  respecify  it. 


RMS_ERR,  RMS  error  code  is  'number* 

Explanation:   The  RMS  file  system  has  encountered  an  error. 

User  Action:  Consult  the  RMS-11  MACRO-11  Reference  Manual  or  the 
VAX- 1 1  Record  Management  Services  Reference  Manual  for  an 
explanation  of  the  error  code. 


M.- 


SEE_CALLS,  the  number_of_f rames  argument   ('count')   must  be  greater 
than  0 

Explanation:   A  zero  argument  to  SHOW  CALLS  is  invalid. 

User  Action:   Correct  the  command  and  reenter  it. 

SHOTOBIG,  SHOW  CALL  count  too  large 

Explanation:   The  SHOW  CALLS  count  is  a  decimal   integer  in      the 
range  0  throught  32767. 

User  Action:   Correct  the  call-count  parameter   and   reissue   th^ 
SHOW  CALLS  command. 

STNNAME,  the  SET   STB^FILE  command   handles   STB   file   names   up   to 
'length*  characters 

Explanation:   The  file  nama  specified  is  longer  than  allowed   by 
the  host  file  system. 

User  Action:   Correct  the  file  name  and  reenter  the  command. 

STPTOBIG,  STEP  count  too  large 

Explanation:   The  maximum  value  of  the  step  count  is  32767. 
User  Action:   Correct  th*?  command  and  reenter  it. 
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STRTRUNC,  string  truncated 

Explanation:   The  string  being  deposited  was   longer 
length  associated  with  the  location  deposited  into. 

User  Action:   None. 


than  the 


SYNTAX,  command  syntax  error  at  or  near  • 'string 


•  I 


Explanation:   A  syntax  error  was  detected  in  the  command 
User  Action:   Correct  the  command,  and  reenter  it. 


TBIT,  unexpected  T-bit  trap 

Explanation:   The  DEBUG   'taskname'   command  was   issued   during 
execution  of  a  debugger  command. 

User  Action:   None. 


TERM_LOST,  error  during  write  of  log  output  to  terminal 

Explanation:   An  I/O  error  occurred  during  terminal  I/O. 
User  Act!^r.:   File  a  Software  Performance  Report. 

TOOLONG,  file  name  too  long 

Explanation:   The  file  name  specified  is   longer  than  allowed  by 
the  host  file  system. 

User  Action:   Correct  the  file  name  and  reenter  the  command. 


TRAP,  TRAP  instruction  executed 

Explanation:   The  debugger  encountered  an  unexpected  error 
User  Action:   File  a  Software  Performance  Report. 


TRSTOVFL,  tree  storage  overflow 

Explanation:   The  parser  has  exhausted  its  tree  storage. 
User  Action:   Reduce  the  complexity  of  *  e  command. 

UNEXPEOF,  unexpected  end  of  file 

Explanation:   The  debugger  has  detected  an  internal  coding  error. 
User  Action:   File  a  Software  Performance  Report. 

UNMATCHED,  unmatched  end-of-rout ine  record  In  STB 

Explanation:   The  debugger  encountered   a   format  error   in  the 
symbol  table  file. 

Usar  Action:   Submit  a  Software  Performance  Report. 


4> 
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VARERR,  symbol  ■•name'"  is  not  an  array  variable 

Explanation:   The  variable  was  specified  with  subscripts,  but   is 
not  dimensional. 


User  Act.  on:   Specify  the  variable  without  a  subscript  list. 


VERIFYICF,  entering  indirect  command  file  "'name 


I  N 


Explanation:   The  debugger  is  executing   the   specified   command 
file. 

User  Action:   None. 


VERIFYICF,  exiting  indirect  command  file  "'name'" 

Explanation:  'Hie  debugger  has  finished  executing   the   specified 
command  file. 

User  Action:  None. 


WHEN_ERR,  error  in  evaluation  of  WHEN 

Explanation:  An  error  was  encountered  attempting  to  evaluate  a 
WHEN  clause.  The  WHEN  clause  is  treated  as  though  it  evaluated 
to  TRUE. 


User  Action:   Correct  the  WHEN  clause. 
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Abbreviations 

keyword,  1-4 
Address  arithmetic,  2-9 
Address  expression 

value  of,  2-8 
Address  expressions 

operands  in,  2-8 
/AFTER:n  qualifier,  3-5  to  3-6 
ASCII  strinvj 

deposit  of,  4-7 

Backslash 

as  current  value,  2-7 

use  of ,  2-4 
Breakpoint 

activation  of,  3-5 

at  routine,  3^6 

canceling,  5-4 

disabling,  3-6 

duration  of ,  3-6 

effect  of,  3-5 

enabling,  3-6 

establishing,  3-5 

Call-count,  3-9 
/CALLS  qualifier,  3-5,  3-8 
CANCEL  ALL  command,  3-11,  5-2 
CANCEL  BREAK  command,  3-6,  5-3 
CANCEL  MODE  command,  4-1,  5-5 
CANCEL  OUTPUT  command,  1-5,  5-6 
CANCEL  SCOPE  command,  2-5,  5-7 
CANCEL  STEP  com aand ,  5-8 
CANCEL  TRACE  command,  3-8,  5-9 
CANCEL  TYPE  command,  4-4,  5-10 
Circumflex 

as  logical  successor,  2-7 
Compi 1 i  ng 

RSTS,  1-2 

RSX,  1-2 

VMS,  1-3 
CTRL/C,  1-3 
CTRL/Y,  1-3 
CTRL/Z,  1-3.  3-1 
Current  location,  2-2,  2-7 
Current  value,  2-2,  2-7 


Data    types 

/association   wi^h    locations,    4-4 

compi l#r -generated ,    4-4 

c<^L»ugger  ,4-3 

uebuggrr  default,  4-4 

FORTRAN-77,  4-3 

specifying,  4-4 
DErr^E  command,  2-2,  5-11 
DEPOSIT  command,  4-6,  5-12 

and  mode,  4-7 

and  t/pe,  4-6 
DIbABLE  tREAK  command,  3-6,  5-15 
DISABLE  TRACE  command,  3-8,  5-16 


DO  action,  3-5,  3-7 
nesting  of,  3-7 
with  WHEN,  3-7 

ENABLE  BREAK  command,  3-6,  5-17 
ENABLE  TRACE  command,  3-8,  5-18 
EVALUATE  command,  2-9,  5-19 
EXAMINE  command,  4-5,  5-20 

and  type,  4-5 
EXIT  command,  1-2,  3-1,  5-23 

File 

log,  1-5 
§f lie-spec  command,  1-5,  5-1 
Files 

indirect  command,  1-5 

log,  1-4 
Floating-point  status  wo.d,  2-2 

GO  command,  3-1,  5-24 

HELP  command,  1-6,  5-25 

Interrupting  the  debugger,  1-3 

Line  numbers,  2-2,  2-6 
Linking 

VMS,  1-3 
Literals,  2-6 
Logical  predecessor,  2-2 
Logical  successor,  2-2,  2-7 

MACRO- 11 

debugging,  ?-4 
pathnames  in,  2-4 
symbol  names,  2-4 
Mode,  5-5 

definition  of,  4-1 
radix,  4-1 

qualifiers,  4-1 
symbol,  4-1  to  4-2 

and  FS,  4-3 

and  PS,  4-3 

Operators 

in  address  expressions,  2-8 

In  value  expressions,  2-8 
Optimization 

effectsof,  1-3 
Output  configuration 

default,  1-5 
Overlays 

deposit  into,  4-7 

pathname  in ,  2-4 

segment ,  2-4 


Pathnames,  2-3 

line    nukiiber    in,    2-6 
Percent    sign,    2-6 
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Period 

as  current  location,  2-7 
Processor  status  word,  2-2 

RAD50  string 

deposit  of ,  4-7 
Registers,  2-2 
RETURN 

as  logical  successor,  2-7 


Scope,  2-3  to  2-4,  5-7 

default,  2-3 

PC,  2-3 

prefix,  2-5 

specifying,  2-3 
Segment 

overlay,  2-2 
SET  BREAK  command,  3 
SET  LOG  command,  1-4 
SET  MODE  command,  4- 
SET  OUTPUT  command, 

5-29 
SET  SCOPE  command,  2 
SET  STB  command,  2-2 
SET  STEP  command,  3- 
SET  TRACE  command,  3 
SET  TYPE  command,  4- 
SKOW  ^LL  command,  3- 
SHOW  BREAK  command, 
SHOW  CALLS  command, 
SHOW  LOG  command,  5- 
SHOW  MODE  command,  4 
SHOW  OUTPUT  command, 
SHOW  SCOPE  command, 
SHOW  STB  command,  5- 
SHOw  STB  command ,  2- 
SHOW  STEP  command,  3 
SHOW  TRACE  command, 
SHOW  TYPE  command,  4 
Start-up 

debugger,  1-1,  3-1 
STB  file,  2-1 

name  of,  2-2 
STEP  command,  5-46 

effects  of,  3-2 


-5,  5-26 

,    5-27 

1,  5-28 
1-4  to  1-5, 

-5,  5-30 
,    5-31 

2,  5-32 
-8.  5-33 
4,  5-34 
11,  5-35 
3-6,  5-36 
3-9,  5-37 
38 
-1,  5-39 

1-5,  5-40 
2-5,  5-41  , 
42 
2 

-3,  5-43 
3-8,  5-44 
-4,  5-45 


Step  conditions,  3-2 

changing,  3-2 

displaying,  3-3 
STEP  sequence,  3-3 
Stepping 

examples  of ,  3-3 
Stopping  the  debugger,  3-1 
Subscripts,  2-3 
Svmbol  table,  2-1 
Symbols 

creat  ing  ,  2-2 

defined,  2-6 

defining,  5-11 

logical  successor,  2-7 

permanent,  2-6 

program,  2-1,  2-6 
Syntax 

debugger  command,  1-4 


Task-building 

RSTS,  1-2 

RSX,  1-2 
Termination 

of  debugger ,  1-2 
Tracepoint 

activation  of,  3-8 

disabling,  3-8 

duration  of ,  3-8 

effect  of,  3-8 

enabling,  3-8 

purpose  of,  3-8 
Type,  4-3 

association  with  address 
expression,  4-3 


UNDEFINE  command,  5-48 


Valu   expression 
evaluation  of,  2-8 
with  WHEN,  3-5,  3-7 


WHEN  value  expression,  3-7 
with  DO,  3-7 
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